#include "coreprivshared.hpp"

Include dependency graph for fxcxdeviceinitapi.cpp:

Functions
static __inline NTSTATUS	FxValiateCx (__in PFX_DRIVER_GLOBALS FxDriverGlobals, __in PFX_DRIVER_GLOBALS CxDriverGlobals)

_Must_inspect_result_	__drv_maxIRQL (DISPATCH_LEVEL) WDFAPI NTSTATUS NTAPI WDFEXPORT(WdfCxDeviceInitAssignWdmIrpPreprocessCallback)(__in PWDF_DRIVER_GLOBALS DriverGlobals

_Must_inspect_result_ __in PWDFCXDEVICE_INIT __in PFN_WDFCXDEVICE_WDM_IRP_PREPROCESS __in UCHAR	__drv_when (NumMinorFunctions > 0, __in_bcount(NumMinorFunctions)) __drv_when(NumMinorFunctions

	FxPointerNotNull (cxDriverGlobals, CxDeviceInit)

	if (!NT_SUCCESS(status))

	FxPointerNotNull (fxDriverGlobals, EvtCxDeviceWdmIrpPreprocess)

	if (NumMinorFunctions > 0)

	if (MajorFunction >=ARRAY_SIZE(CxDeviceInit->PreprocessInfo->Dispatch))

	if (CxDeviceInit->PreprocessInfo==NULL)

	ASSERT (CxDeviceInit->PreprocessInfo->ClassExtension)

	FxPointerNotNull (fxDriverGlobals, EvtIoInCallerContext)

	FxPointerNotNull (fxDriverGlobals, RequestAttributes)

RtlCopyMemory &	CxDeviceInit (WDF_OBJECT_ATTRIBUTES)

	FxPointerNotNull (fxDriverGlobals, CxFileObjectConfig)

	if (CxFileObjectConfig->Size !=sizeof(WDFCX_FILEOBJECT_CONFIG))

	switch (CxFileObjectConfig->AutoForwardCleanupClose)

	if (normalizedFileClass==WdfFileObjectInvalid\|\|normalizedFileClass > WdfFileObjectWdfCannotUseFsContexts)

	if (FxIsFileObjectOptional(CxFileObjectConfig->FileObjectClass))

RtlCopyMemory &	CxDeviceInit (CxDeviceInit->FileObject.Callbacks)

	if (FileObjectAttributes !=NULL)

_Must_inspect_result_	__drv_maxIRQL (PASSIVE_LEVEL) PWDFCXDEVICE_INIT NTAPI WDFEXPORT(WdfCxDeviceInitAllocate)(__in PWDF_DRIVER_GLOBALS DriverGlobals

	FxPointerNotNull (cxDriverGlobals, DeviceInit)

	if (NULL==cxDeviceInit)

Variables
_Must_inspect_result_ __in PWDFCXDEVICE_INIT	CxDeviceInit

_Must_inspect_result_ __in PWDFCXDEVICE_INIT __in PFN_WDFCXDEVICE_WDM_IRP_PREPROCESS	EvtCxDeviceWdmIrpPreprocess

_Must_inspect_result_ __in PWDFCXDEVICE_INIT __in PFN_WDFCXDEVICE_WDM_IRP_PREPROCESS __in UCHAR	MajorFunction

_Must_inspect_result_ __in PWDFCXDEVICE_INIT __in PFN_WDFCXDEVICE_WDM_IRP_PREPROCESS __in UCHAR __in_opt PUCHAR	MinorFunctions

_Must_inspect_result_ __in PWDFCXDEVICE_INIT __in PFN_WDFCXDEVICE_WDM_IRP_PREPROCESS __in UCHAR __in_opt PUCHAR __in ULONG	NumMinorFunctions

PFX_DRIVER_GLOBALS	fxDriverGlobals = CxDeviceInit->ClientDriverGlobals

PFX_DRIVER_GLOBALS	cxDriverGlobals = GetFxDriverGlobals(DriverGlobals)

NTSTATUS	status = FxValiateCx(fxDriverGlobals, cxDriverGlobals)

CxDeviceInit PreprocessInfo Dispatch[MajorFunction]	EvtCxDevicePreprocess

Done	__pad0__

__in PWDFCXDEVICE_INIT __in PFN_WDF_IO_IN_CALLER_CONTEXT	EvtIoInCallerContext

CxDeviceInit	IoInCallerContextCallback = EvtIoInCallerContext

Done	__pad1__

__in PWDFCXDEVICE_INIT __in PWDF_OBJECT_ATTRIBUTES	RequestAttributes

Done	__pad2__

__in PWDFCXDEVICE_INIT __in PWDFCX_FILEOBJECT_CONFIG	CxFileObjectConfig

__in PWDFCXDEVICE_INIT __in PWDFCX_FILEOBJECT_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES	FileObjectAttributes

WDF_FILEOBJECT_CLASS	normalizedFileClass

CxDeviceInit FileObject	Set = TRUE

CxDeviceInit FileObject	AutoForwardCleanupClose

CxDeviceInit FileObject	Class = CxFileObjectConfig->FileObjectClass

Done	__pad3__

_Must_inspect_result_ __in PWDFDEVICE_INIT	DeviceInit

PWDFCXDEVICE_INIT	cxDeviceInit = NULL

cxDeviceInit	ClientDriverGlobals = fxDriverGlobals

cxDeviceInit	CxDriverGlobals = cxDriverGlobals

Done	__pad4__

Function Documentation

◆ __drv_maxIRQL() [1/2]

_Must_inspect_result_ __drv_maxIRQL ( DISPATCH_LEVEL )

◆ __drv_maxIRQL() [2/2]

_Must_inspect_result_ __drv_maxIRQL ( PASSIVE_LEVEL )

◆ __drv_when()

_Must_inspect_result_ __in PWDFCXDEVICE_INIT __in PFN_WDFCXDEVICE_WDM_IRP_PREPROCESS __in UCHAR __drv_when	(	NumMinorFunctions	,
		0	,
		__in_bcount(NumMinorFunctions)
	)

◆ ASSERT()

ASSERT ( CxDeviceInit->PreprocessInfo-> ClassExtension )

◆ CxDeviceInit() [1/2]

RtlCopyMemory & CxDeviceInit ( CxDeviceInit->FileObject. Callbacks )

◆ CxDeviceInit() [2/2]

RtlCopyMemory & CxDeviceInit ( WDF_OBJECT_ATTRIBUTES )

◆ FxPointerNotNull() [1/6]

FxPointerNotNull	(	cxDriverGlobals	,
		CxDeviceInit
	)

◆ FxPointerNotNull() [2/6]

FxPointerNotNull	(	cxDriverGlobals	,
		DeviceInit
	)

◆ FxPointerNotNull() [3/6]

FxPointerNotNull	(	fxDriverGlobals	,
		CxFileObjectConfig
	)

◆ FxPointerNotNull() [4/6]

FxPointerNotNull	(	fxDriverGlobals	,
		EvtCxDeviceWdmIrpPreprocess
	)

◆ FxPointerNotNull() [5/6]

FxPointerNotNull	(	fxDriverGlobals	,
		EvtIoInCallerContext
	)

◆ FxPointerNotNull() [6/6]

FxPointerNotNull	(	fxDriverGlobals	,
		RequestAttributes
	)

◆ FxValiateCx()

static __inline NTSTATUS FxValiateCx	(	__in PFX_DRIVER_GLOBALS	FxDriverGlobals,
		__in PFX_DRIVER_GLOBALS	CxDriverGlobals
	)

static

Definition at line 42 of file fxcxdeviceinitapi.cpp.

{
    NTSTATUS status = STATUS_SUCCESS;
 
    if (FxIsClassExtension(FxDriverGlobals, CxDriverGlobals) == FALSE) {
        status = STATUS_INVALID_DEVICE_REQUEST;
        DoTraceLevelMessage(FxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "This function can only be called by a WDF "
                            "extension driver, Driver 0x%p, %!STATUS!",
                            CxDriverGlobals->Public.Driver, status);
        FxVerifierDbgBreakPoint(FxDriverGlobals);
    }
 
    return status;
}

◆ if() [1/9]

if ( ! NT_SUCCESSstatus )

Definition at line 96 of file fxcxdeviceinitapi.cpp.

                             {
        goto Done;
    }

◆ if() [2/9]

if ( CxDeviceInit-> PreprocessInfo = = NULL )

Definition at line 124 of file fxcxdeviceinitapi.cpp.

                                              {
        CxDeviceInit->PreprocessInfo = new(fxDriverGlobals) FxIrpPreprocessInfo();
        if (CxDeviceInit->PreprocessInfo == NULL) {
            status = STATUS_INSUFFICIENT_RESOURCES;
            DoTraceLevelMessage(fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                                "Couldn't create object PreprocessInfo, "
                                "%!STATUS!", status);
 
            goto Done;
        }
        CxDeviceInit->PreprocessInfo->ClassExtension = TRUE;
    }

◆ if() [3/9]

if ( CxFileObjectConfig->Size ! = sizeof(WDFCX_FILEOBJECT_CONFIG) )

Definition at line 356 of file fxcxdeviceinitapi.cpp.

                                                                     {
        DoTraceLevelMessage(
            fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Invalid CxFileObjectConfig Size %d, expected %d",
            CxFileObjectConfig->Size, sizeof(WDFCX_FILEOBJECT_CONFIG));
 
        FxVerifierDbgBreakPoint(fxDriverGlobals);
        goto Done;
    }

◆ if() [4/9]

if ( FileObjectAttributes ! = NULL )

Definition at line 447 of file fxcxdeviceinitapi.cpp.

                                      {
        RtlCopyMemory(&CxDeviceInit->FileObject.Attributes,
                      FileObjectAttributes,
                      sizeof(CxDeviceInit->FileObject.Attributes));
    }

◆ if() [5/9]

if ( FxIsFileObjectOptional(CxFileObjectConfig->FileObjectClass) )

Definition at line 423 of file fxcxdeviceinitapi.cpp.

                                                                     {
        switch(normalizedFileClass) {
        case WdfFileObjectWdfCanUseFsContext:
        case WdfFileObjectWdfCanUseFsContext2:
        case WdfFileObjectWdfCannotUseFsContexts:
            break;
 
        default:
            DoTraceLevelMessage(
                fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "Invalid CxFileObjectConfig->FileObjectClass %d",
                CxFileObjectConfig->FileObjectClass);
            FxVerifierDbgBreakPoint(fxDriverGlobals);
            goto Done;
            break; // just in case static verification tools complain.
        }
    }

◆ if() [6/9]

if ( MajorFunction >= ARRAY_SIZECxDeviceInit->PreprocessInfo->Dispatch )

Definition at line 111 of file fxcxdeviceinitapi.cpp.

                                                                             {
        status = STATUS_INVALID_PARAMETER;
        DoTraceLevelMessage(fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "MajorFunction %x is invalid, %!STATUS!",
                            (ULONG)MajorFunction, status);
 
        goto Done;
    }

◆ if() [7/9]

if	(	normalizedFileClass	= `= WdfFileObjectInvalid \|\| normalizedFileClass`,
		WdfFileObjectWdfCannotUseFsContexts
	)

Definition at line 410 of file fxcxdeviceinitapi.cpp.

                                                                    {
        DoTraceLevelMessage(
            fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Out of range CxFileObjectConfig->FileObjectClass %d",
            CxFileObjectConfig->FileObjectClass);
        FxVerifierDbgBreakPoint(fxDriverGlobals);
        goto Done;
    }

◆ if() [8/9]

if ( NULL = = cxDeviceInit )

Definition at line 494 of file fxcxdeviceinitapi.cpp.

                              {
        goto Done;
    }

◆ if() [9/9]

if	(	NumMinorFunctions	,
		0
	)

Definition at line 102 of file fxcxdeviceinitapi.cpp.

                               {
        FxPointerNotNull(fxDriverGlobals, MinorFunctions);
    }

◆ switch()

switch ( CxFileObjectConfig-> AutoForwardCleanupClose )

Definition at line 382 of file fxcxdeviceinitapi.cpp.

                                                         {
    case WdfTrue:
    case WdfFalse:
    case WdfUseDefault:
        break;
 
    default:
        DoTraceLevelMessage(
            fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Invalid CxFileObjectConfig->AutoForwardCleanupClose value 0x%x, "
            "expected WDF_TRI_STATE value",
            CxFileObjectConfig->AutoForwardCleanupClose);
 
        FxVerifierDbgBreakPoint(fxDriverGlobals);
        goto Done;
    }