wdfstring.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	WDF_EXTERN_C
#define	WDF_EXTERN_C_START
#define	WDF_EXTERN_C_END

Functions
WDF_EXTERN_C_START typedef _Must_inspect_result_	_IRQL_requires_max_ (PASSIVE_LEVEL) WDFAPI NTSTATUS(STDCALL *PFN_WDFSTRINGCREATE)(_In_ PWDF_DRIVER_GLOBALS DriverGlobals

Variables
WDF_EXTERN_C_START typedef _Must_inspect_result_ _In_opt_ PCUNICODE_STRING	UnicodeString
WDF_EXTERN_C_START typedef _Must_inspect_result_ _In_opt_ PCUNICODE_STRING _In_opt_ PWDF_OBJECT_ATTRIBUTES	StringAttributes
WDF_EXTERN_C_START typedef _Must_inspect_result_ _In_opt_ PCUNICODE_STRING _In_opt_ PWDF_OBJECT_ATTRIBUTES _Out_ WDFSTRING *	String

Macro Definition Documentation

WDF_EXTERN_C

#define WDF_EXTERN_C

Definition at line 38 of file wdfstring.h.

WDF_EXTERN_C_END

#define WDF_EXTERN_C_END

Definition at line 40 of file wdfstring.h.

WDF_EXTERN_C_START

#define WDF_EXTERN_C_START

Definition at line 39 of file wdfstring.h.

Function Documentation

_IRQL_requires_max_()

WDF_EXTERN_C_START typedef _Must_inspect_result_ _IRQL_requires_max_

(

PASSIVE_LEVEL

)

Definition at line 64 of file Messaging.c.

{
    PFLT_SERVER_PORT_OBJECT PortObject;
    NTSTATUS Status;

    /* The caller must allow at least one connection */
    if (MaxConnections == 0)
    {
        return STATUS_INVALID_PARAMETER;
    }

    /* The request must be for a kernel handle */
    if (!(ObjectAttributes->Attributes & OBJ_KERNEL_HANDLE))
    {
        return STATUS_INVALID_PARAMETER;
    }

    /*
     * Get rundown protection on the target to stop the owner
     * from unloading whilst this port object is open. It gets
     * removed in the FltpServerPortClose callback
     */
    Status = FltObjectReference(Filter);
    if (!NT_SUCCESS(Status))
    {
        return Status;
    }

    /* Create the server port object for this filter */
    Status = ObCreateObject(KernelMode,
                            ServerPortObjectType,
                            ObjectAttributes,
                            KernelMode,
                            NULL,
                            sizeof(FLT_SERVER_PORT_OBJECT),
                            0,
                            0,
                            (PVOID *)&PortObject);
    if (NT_SUCCESS(Status))
    {
        /* Zero out the struct */
        RtlZeroMemory(PortObject, sizeof(FLT_SERVER_PORT_OBJECT));

        /* Increment the ref count on the target filter */
        FltpObjectPointerReference((PFLT_OBJECT)Filter);

        /* Setup the filter port object */
        PortObject->Filter = Filter;
        PortObject->ConnectNotify = ConnectNotifyCallback;
        PortObject->DisconnectNotify = DisconnectNotifyCallback;
        PortObject->MessageNotify = MessageNotifyCallback;
        PortObject->Cookie = ServerPortCookie;
        PortObject->MaxConnections = MaxConnections;

        /* Insert the object */
        Status = ObInsertObject(PortObject,
                                NULL,
                                STANDARD_RIGHTS_ALL | FILE_READ_DATA,
                                0,
                                NULL,
                                (PHANDLE)ServerPort);
        if (NT_SUCCESS(Status))
        {
            /* Lock the connection list */
            ExAcquireFastMutex(&Filter->ConnectionList.mLock);

            /* Add the new port object to the connection list and increment the count */
            InsertTailList(&Filter->ConnectionList.mList, &PortObject->FilterLink);
            Filter->ConnectionList.mCount++;

            /* Unlock the connection list*/
            ExReleaseFastMutex(&Filter->ConnectionList.mLock);
        }
    }

    if (!NT_SUCCESS(Status))
    {
        /* Allow the filter to be cleaned up */
        FltObjectDereference(Filter);
    }

    return Status;
}

Variable Documentation

String

typedef _In_ WDFSTRING String

Initial value:

{
    return ((PFN_WDFSTRINGCREATE) WdfFunctions[WdfStringCreateTableIndex])(WdfDriverGlobals, UnicodeString, StringAttributes, String)

Definition at line 64 of file wdfstring.h.

StringAttributes

_Must_inspect_result_ _In_opt_ PWDF_OBJECT_ATTRIBUTES StringAttributes

Definition at line 64 of file wdfstring.h.

UnicodeString

_In_ WDFSTRING _Out_ PUNICODE_STRING UnicodeString

Initial value:

{
    ((PFN_WDFSTRINGGETUNICODESTRING) WdfFunctions[WdfStringGetUnicodeStringTableIndex])(WdfDriverGlobals, String, UnicodeString)

Definition at line 64 of file wdfstring.h.

Referenced by AppendMenuA(), AsciiToUnicode(), BlStatusPrint(), CabinetExtractFile(), CabinetFindNext(), CmpAddDriverToList(), CmpFindDrivers(), ConvertSidToStringSidW(), CopyQuerySetIndirectW(), DefSetText(), DriverEntry(), DsAddressToSiteNamesA(), DsAddressToSiteNamesExA(), DsEnumerateDomainTrustsA(), DsGetDcNameWithAccountA(), DsGetDcSiteCoverageA(), EraseLine(), FatalAppExitW(), FatSearchBufferForLabel(), FatSetFsLabelInfo(), GetComputerNameExA(), ImmLoadLayout(), InsertMenuA(), InsertMenuItemA(), InternalAddAtom(), InternalFindAtom(), InternalGetAtomName(), IntMsgCreateStructW(), IntVideoPortMapPhysicalMemory(), ModifyMenuA(), MsgiAnsiToUnicodeCleanup(), MsgiAnsiToUnicodeMessage(), MsgiUnicodeToAnsiMessage(), NetpAllocAnsiStrFromWStr(), NetpAllocStrFromWStr(), NetpAllocWStrFromAnsiStr(), NetpAllocWStrFromStr(), NtUserDefSetText(), OutputDebugStringW(), PciGetDescriptionMessage(), PrintString(), QueryDosDeviceW(), ReadStringFromRegistry(), RegQueryInfoKeyA(), RtlUnicodeToCustomCPN(), RtlUpcaseUnicodeToCustomCPN(), ScBuildAnsiArgsVector(), SerenumInitMultiSzString(), SetCurrentDirectoryW(), SetMenuItemInfoA(), SetMenuItemInfoW(), SmpTranslateSystemPartitionInformation(), SpiCreatePortConfig(), SpiParseDeviceInfo(), USBPORT_UserGetRootHubName(), WriteConsoleOutputCharacterW(), WSAAddressToStringA(), and WSAStringToAddressA().