wdfqueryinterface.h File Reference

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

Go to the source code of this file.

Classes
struct	_WDF_QUERY_INTERFACE_CONFIG

Macros
#define	WDF_EXTERN_C
#define	WDF_EXTERN_C_START
#define	WDF_EXTERN_C_END

Typedefs
typedef EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST *	PFN_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST
typedef struct _WDF_QUERY_INTERFACE_CONFIG	WDF_QUERY_INTERFACE_CONFIG
typedef struct _WDF_QUERY_INTERFACE_CONFIG *	PWDF_QUERY_INTERFACE_CONFIG
typedef _Must_inspect_result_	_IRQL_requires_max_(PASSIVE_LEVEL) WDFAPI NTSTATUS(STDCALL *PFN_WDFDEVICEADDQUERYINTERFACE) (_In_ PWDF_DRIVER_GLOBALS DriverGlobals
typedef _Must_inspect_result_ _In_ WDFDEVICE	Device
typedef _Must_inspect_result_ _In_ WDFDEVICE _In_ PWDF_QUERY_INTERFACE_CONFIG	InterfaceConfig

Functions
WDF_EXTERN_C_START typedef	_Function_class_ (EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST) _IRQL_requires_same_ _IRQL_requires_max_(PASSIVE_LEVEL) NTSTATUS STDCALL EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST(_In_ WDFDEVICE Device
FORCEINLINE VOID	WDF_QUERY_INTERFACE_CONFIG_INIT (_Out_ PWDF_QUERY_INTERFACE_CONFIG InterfaceConfig, _In_opt_ PINTERFACE Interface, _In_ CONST GUID *InterfaceType, _In_opt_ PFN_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST EvtDeviceProcessQueryInterfaceRequest)
_Must_inspect_result_	_IRQL_requires_max_ (PASSIVE_LEVEL) FORCEINLINE NTSTATUS WdfDeviceAddQueryInterface(_In_ WDFDEVICE Device
FORCEINLINE VOID	WdfDeviceInterfaceReferenceNoOp (_In_ PVOID Context)
FORCEINLINE VOID	WdfDeviceInterfaceDereferenceNoOp (_In_ PVOID Context)

Variables
WDF_EXTERN_C_START typedef _In_ LPGUID	InterfaceType
WDF_EXTERN_C_START typedef _In_ LPGUID _Inout_ PINTERFACE	ExposedInterface
WDF_EXTERN_C_START typedef _In_ LPGUID _Inout_ PINTERFACE _Inout_opt_ PVOID	ExposedInterfaceSpecificData

Macro Definition Documentation

WDF_EXTERN_C

#define WDF_EXTERN_C

Definition at line 38 of file wdfqueryinterface.h.

WDF_EXTERN_C_END

#define WDF_EXTERN_C_END

Definition at line 40 of file wdfqueryinterface.h.

WDF_EXTERN_C_START

#define WDF_EXTERN_C_START

Definition at line 39 of file wdfqueryinterface.h.

Typedef Documentation

_IRQL_requires_max_

typedef _Must_inspect_result_ _IRQL_requires_max_(PASSIVE_LEVEL) WDFAPI NTSTATUS(STDCALL *PFN_WDFDEVICEADDQUERYINTERFACE)(_In_ PWDF_DRIVER_GLOBALS DriverGlobals

Definition at line 152 of file wdfqueryinterface.h.

Device

typedef _Must_inspect_result_ _In_ WDFDEVICE Device

Definition at line 159 of file wdfqueryinterface.h.

InterfaceConfig

_Must_inspect_result_ _In_ PWDF_QUERY_INTERFACE_CONFIG InterfaceConfig

Initial value:

{
    return ((PFN_WDFDEVICEADDQUERYINTERFACE) WdfFunctions[WdfDeviceAddQueryInterfaceTableIndex])(WdfDriverGlobals, Device, InterfaceConfig)

Definition at line 159 of file wdfqueryinterface.h.

PFN_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST

typedef EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST* PFN_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST

Definition at line 69 of file wdfqueryinterface.h.

PWDF_QUERY_INTERFACE_CONFIG

typedef struct _WDF_QUERY_INTERFACE_CONFIG * PWDF_QUERY_INTERFACE_CONFIG

WDF_QUERY_INTERFACE_CONFIG

typedef struct _WDF_QUERY_INTERFACE_CONFIG WDF_QUERY_INTERFACE_CONFIG

Function Documentation

_Function_class_()

WDF_EXTERN_C_START typedef _Function_class_

(

EVT_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST

)

_IRQL_requires_max_()

_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;
}

WDF_QUERY_INTERFACE_CONFIG_INIT()

FORCEINLINE VOID WDF_QUERY_INTERFACE_CONFIG_INIT	(	_Out_ PWDF_QUERY_INTERFACE_CONFIG	InterfaceConfig,
		_In_opt_ PINTERFACE	Interface,
		_In_ CONST GUID *	InterfaceType,
		_In_opt_ PFN_WDF_DEVICE_PROCESS_QUERY_INTERFACE_REQUEST	EvtDeviceProcessQueryInterfaceRequest
	)

Definition at line 131 of file wdfqueryinterface.h.

{
    RtlZeroMemory(InterfaceConfig, sizeof(WDF_QUERY_INTERFACE_CONFIG));

    InterfaceConfig->Size = sizeof(WDF_QUERY_INTERFACE_CONFIG);
    InterfaceConfig->Interface = Interface;
    InterfaceConfig->InterfaceType = InterfaceType;
    InterfaceConfig->EvtDeviceProcessQueryInterfaceRequest =
        EvtDeviceProcessQueryInterfaceRequest;
}

WdfDeviceInterfaceDereferenceNoOp()

FORCEINLINE VOID WdfDeviceInterfaceDereferenceNoOp

(

_In_ PVOID

Context

)

Definition at line 202 of file wdfqueryinterface.h.

{
    UNREFERENCED_PARAMETER(Context);
}

WdfDeviceInterfaceReferenceNoOp()

FORCEINLINE VOID WdfDeviceInterfaceReferenceNoOp

(

_In_ PVOID

Context

)

Definition at line 193 of file wdfqueryinterface.h.

{
    UNREFERENCED_PARAMETER(Context);
}

Variable Documentation

ExposedInterface

WDF_EXTERN_C_START typedef _In_ LPGUID _Inout_ PINTERFACE ExposedInterface

Definition at line 62 of file wdfqueryinterface.h.

Referenced by FxDeviceProcessQueryInterfaceRequest::Invoke().

ExposedInterfaceSpecificData

WDF_EXTERN_C_START typedef _In_ LPGUID _Inout_ PINTERFACE _Inout_opt_ PVOID ExposedInterfaceSpecificData

Definition at line 62 of file wdfqueryinterface.h.

Referenced by FxDeviceProcessQueryInterfaceRequest::Invoke().

InterfaceType

WDF_EXTERN_C_START typedef _In_ LPGUID InterfaceType

Definition at line 62 of file wdfqueryinterface.h.

Referenced by WDF_QUERY_INTERFACE_CONFIG_INIT().