fxdeviceinitapi.cpp File Reference

#include "coreprivshared.hpp"

Include dependency graph for fxdeviceinitapi.cpp:

Go to the source code of this file.

Classes
struct	_WDF_PNPPOWER_EVENT_CALLBACKS_V1_9
struct	_WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5
struct	_WDF_PDO_EVENT_CALLBACKS_V1_9

Typedefs
typedef struct _WDF_PNPPOWER_EVENT_CALLBACKS_V1_9	WDF_PNPPOWER_EVENT_CALLBACKS_V1_9
typedef struct _WDF_PNPPOWER_EVENT_CALLBACKS_V1_9 *	PWDF_PNPPOWER_EVENT_CALLBACKS_V1_9
typedef struct _WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5	WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5
typedef struct _WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5 *	PWDF_POWER_POLICY_EVENT_CALLBACKS_V1_5
typedef struct _WDF_PDO_EVENT_CALLBACKS_V1_9	WDF_PDO_EVENT_CALLBACKS_V1_9
typedef struct _WDF_PDO_EVENT_CALLBACKS_V1_9 *	PWDF_PDO_EVENT_CALLBACKS_V1_9

Functions
	__drv_maxIRQL (DISPATCH_LEVEL) VOID STDCALL WDFEXPORT(WdfDeviceInitFree)(__in PWDF_DRIVER_GLOBALS DriverGlobals
	FxPointerNotNull (GetFxDriverGlobals(DriverGlobals), DeviceInit)
	if (DeviceInit->CreatedOnStack==FALSE)
	_IRQL_requires_max_ (PASSIVE_LEVEL) WDFAPI VOID STDCALL WDFEXPORT(WdfDeviceInitSetIoTypeEx)(_In_ PWDF_DRIVER_GLOBALS DriverGlobals
	Queries information details about a security descriptor.
	FxPointerNotNull (pFxDriverGlobals, DeviceInit)
	if (IoTypeConfig->Size !=sizeof(WDF_IO_TYPE_CONFIG))
DeviceInit	AssignIoType (IoTypeConfig)
_Must_inspect_result_	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS STDCALL WDFEXPORT(WdfDeviceInitAssignName)(__in PWDF_DRIVER_GLOBALS DriverGlobals
	if (!NT_SUCCESS(status))
	if (DeviceName !=NULL)
	if (DeviceName==NULL)
return DeviceInit	AssignName (DeviceInit->DriverGlobals, DeviceName)
	if (OrInValues)
	if ((DeviceCharacteristics &FILE_AUTOGENERATED_DEVICE_NAME) &&DeviceInit->DeviceName !=NULL)
	FxPointerNotNull (pFxDriverGlobals, FileObjectConfig)
	if (FileObjectConfig->Size !=sizeof(WDF_FILEOBJECT_CONFIG))
	switch (FileObjectConfig->AutoForwardCleanupClose)
	if (normalizedFileClass==WdfFileObjectInvalid||normalizedFileClass > WdfFileObjectWdfCannotUseFsContexts)
	if (pFxDriverGlobals->IsUserModeDriver &&(normalizedFileClass==WdfFileObjectWdfCanUseFsContext||normalizedFileClass==WdfFileObjectWdfCanUseFsContext2))
	if (FxIsFileObjectOptional(fileClass))
RtlCopyMemory &	DeviceInit (DeviceInit->FileObject.Callbacks)
	if (FileObjectAttributes !=NULL)
	FxPointerNotNull (pFxDriverGlobals, RequestAttributes)
RtlCopyMemory &	DeviceInit (WDF_OBJECT_ATTRIBUTES)
	if (SDDLString==NULL)
	if (DeviceInit->Security.Sddl==NULL)
return DeviceInit Security Sddl	Assign (SDDLString)
	FxPointerNotNull (pFxDriverGlobals, DeviceClassGuid)
RtlCopyMemory &	DeviceInit (GUID)
	FxPointerNotNull (pFxDriverGlobals, PnpPowerEventCallbacks)
	if (PnpPowerEventCallbacks->Size !=sizeof(WDF_PNPPOWER_EVENT_CALLBACKS) &&PnpPowerEventCallbacks->Size !=sizeof(_WDF_PNPPOWER_EVENT_CALLBACKS_V1_9))
	if (PnpPowerEventCallbacks->Size > sizeof(WDF_PNPPOWER_EVENT_CALLBACKS_V1_9) &&PnpPowerEventCallbacks->EvtDeviceUsageNotification !=NULL &&PnpPowerEventCallbacks->EvtDeviceUsageNotificationEx !=NULL)
	FxPointerNotNull (pFxDriverGlobals, PowerPolicyEventCallbacks)
	if (PowerPolicyEventCallbacks->Size !=sizeof(WDF_POWER_POLICY_EVENT_CALLBACKS) &&PowerPolicyEventCallbacks->Size !=sizeof(WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5))
	if (PowerPolicyEventCallbacks->Size > sizeof(WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5) &&PowerPolicyEventCallbacks->EvtDeviceArmWakeFromSx !=NULL &&PowerPolicyEventCallbacks->EvtDeviceArmWakeFromSxWithReason !=NULL)
	FxPointerNotNull (pFxDriverGlobals, EvtDevicePnpStateChange)
	if (normalizedState< WdfDevStatePnpObjectCreated||normalizedState > WdfDevStatePnpNull)
	if ((CallbackTypes &~StateNotificationAllStates) !=0||CallbackTypes==0x0)
	if (DeviceInit->PnpPower.PnpStateCallbacks==NULL)
	FxPointerNotNull (pFxDriverGlobals, EvtDevicePowerStateChange)
	if (normalizedState< WdfDevStatePowerObjectCreated||normalizedState >=WdfDevStatePowerNull)
	FxPointerNotNull (pFxDriverGlobals, EvtDevicePowerPolicyStateChange)
	if (normalizedState< WdfDevStatePwrPolObjectCreated||normalizedState >=WdfDevStatePwrPolNull)
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR	__drv_when (NumMinorFunctions > 0, __in_bcount(NumMinorFunctions)) __drv_when(NumMinorFunctions
	FxPointerNotNull (pFxDriverGlobals, EvtDeviceWdmIrpPreprocess)
	if (NumMinorFunctions > 0)
	if (MajorFunction >=ARRAY_SIZE(DeviceInit->PreprocessInfo->Dispatch))
	FxPointerNotNull (GetFxDriverGlobals(DriverGlobals), EvtIoInCallerContext)
	FxPointerNotNull (fxDriverGlobals, DeviceInit)
	FxPointerNotNull (fxDriverGlobals, RemoveLockOptions)
	if (RemoveLockOptions->Size !=sizeof(WDF_REMOVE_LOCK_OPTIONS))
	if ((RemoveLockOptions->Flags &~validFlags) !=0)
	if (FxDeviceInitTypeControlDevice==DeviceInit->InitType)
	if ((ReleaseHardwareOrderOnFailure==WdfReleaseHardwareOrderOnFailureInvalid)||(ReleaseHardwareOrderOnFailure > WdfReleaseHardwareOrderOnFailureAfterDescendants))
	_IRQL_requires_max_ (DISPATCH_LEVEL) VOID STDCALL WDFEXPORT(WdfDeviceInitAllowSelfIoTarget)(_In_ PWDF_DRIVER_GLOBALS DriverGlobals
	if (DeviceInit->IsNotFdoInit())
return	reinterpret_cast< PDEVICE_OBJECT > (DeviceInit->Fdo.PhysicalDevice)
	FxPointerNotNull (pFxDriverGlobals, Key)
	if (!NT_SUCCESS(FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL)))
_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in ULONG	__out_bcount_full_opt (BufferLength) PVOID PropertyBuffer
	FxPointerNotNull (pFxDriverGlobals, ResultLength)
	if (BufferLength > 0)
_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in	__drv_strictTypeMatch (__drv_typeExpr) POOL_TYPE PoolType
	FxPointerNotNull (pFxDriverGlobals, PropertyMemory)
	FxVerifierCheckNxPoolType (pFxDriverGlobals, PoolType, pFxDriverGlobals->Tag)
	FxPointerNotNull (pFxDriverGlobals, FdoEventCallbacks)
	if (FdoEventCallbacks->Size !=sizeof(WDF_FDO_EVENT_CALLBACKS))
	if (FdoEventCallbacks->EvtDeviceFilterAddResourceRequirements !=NULL &&FdoEventCallbacks->EvtDeviceRemoveAddedResources==NULL)
RtlCopyMemory &	DeviceInit (DeviceInit->Fdo.EventCallbacks)
	FxPointerNotNull (pFxDriverGlobals, Config)
	if (DefaultDeviceListAttributes !=NULL)
RtlCopyMemory &	DeviceInit (WDF_CHILD_LIST_CONFIG)
	FxPointerNotNull (pFxDriverGlobals, DeviceProperty)
	if (DeviceProperty->Size !=sizeof(WDF_DEVICE_PROPERTY_DATA))
	FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), ParentDevice, FX_TYPE_DEVICE,(PVOID *) &pDevice, &pFxDriverGlobals)
	if (pDevice->IsFdo()==FALSE)
	if (pInit==NULL)
pInit	SetPdo (pDevice)
	FxPointerNotNull (pFxDriverGlobals, DispatchTable)
	if (DispatchTable->Size !=sizeof(WDF_PDO_EVENT_CALLBACKS) &&DispatchTable->Size !=sizeof(WDF_PDO_EVENT_CALLBACKS_V1_9))
RtlCopyMemory &	DeviceInit (WDF_PDO_EVENT_CALLBACKS)
	FxPointerNotNull (pFxDriverGlobals, DeviceID)
	if (DeviceInit->Pdo.DeviceID==NULL)
	if (pID==NULL)
	if (NT_SUCCESS(status))
pID	Release ()
	FxPointerNotNull (pFxDriverGlobals, DeviceLocation)
	if (pDeviceText==NULL)
	if (pDeviceText->m_Description==NULL)
	FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), Driver, FX_TYPE_DRIVER,(PVOID *) &pDriver, &pFxDriverGlobals)
	FxPointerNotNull (pFxDriverGlobals, SDDLString)
	FxPointerNotNull (pFxDriverGlobals, Notification)
	if ((Flags &~(WdfDeviceShutdown|WdfDeviceLastChanceShutdown)) !=0)

Variables
__in PWDFDEVICE_INIT	DeviceInit
__in PWDFDEVICE_INIT __in WDF_DEVICE_IO_TYPE	IoType
WDF_IO_TYPE_CONFIG	ioTypeConfig
ioTypeConfig	ReadWriteIoType = IoType
_In_ PWDFDEVICE_INIT _In_ PWDF_IO_TYPE_CONFIG	IoTypeConfig
NTSTATUS	status
PFX_DRIVER_GLOBALS	pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)
__in PWDFDEVICE_INIT __in BOOLEAN	Exclusive
__in PWDFDEVICE_INIT __in DEVICE_TYPE	DeviceType
DeviceInit	PowerPageable = FALSE
DeviceInit	Inrush = TRUE
_Must_inspect_result_ __in PWDFDEVICE_INIT __in_opt PCUNICODE_STRING	DeviceName
__in PWDFDEVICE_INIT __in ULONG	DeviceCharacteristics
__in PWDFDEVICE_INIT __in ULONG __in BOOLEAN	OrInValues
	else
__in PWDFDEVICE_INIT __in PWDF_FILEOBJECT_CONFIG	FileObjectConfig
__in PWDFDEVICE_INIT __in PWDF_FILEOBJECT_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES	FileObjectAttributes
WDF_FILEOBJECT_CLASS	normalizedFileClass = FxFileObjectClassNormalize(fileClass)
WDF_FILEOBJECT_CLASS	fileClass = FileObjectConfig->FileObjectClass
DeviceInit FileObject	Set = TRUE
DeviceInit FileObject	AutoForwardCleanupClose
DeviceInit FileObject	Class = fileClass
__in PWDFDEVICE_INIT __in PWDF_OBJECT_ATTRIBUTES	RequestAttributes
_Must_inspect_result_ __in PWDFDEVICE_INIT __in_opt PCUNICODE_STRING	SDDLString
__in PWDFDEVICE_INIT __in CONST GUID *	DeviceClassGuid
DeviceInit Security	DeviceClassSet = TRUE
__in PWDFDEVICE_INIT __in PWDF_PNPPOWER_EVENT_CALLBACKS	PnpPowerEventCallbacks
__in PWDFDEVICE_INIT __in PWDF_POWER_POLICY_EVENT_CALLBACKS	PowerPolicyEventCallbacks
__in PWDFDEVICE_INIT __in BOOLEAN	IsPowerPolicyOwner
DeviceInit PnpPower	PowerPolicyOwner = IsPowerPolicyOwner ? WdfTrue : WdfFalse
_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_PNP_STATE	PnpState
_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_PNP_STATE __in PFN_WDF_DEVICE_PNP_STATE_CHANGE_NOTIFICATION	EvtDevicePnpStateChange
_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_PNP_STATE __in PFN_WDF_DEVICE_PNP_STATE_CHANGE_NOTIFICATION __in ULONG	CallbackTypes
FxPnpStateCallbackInfo *	pCallback
ULONG	normalizedState = WdfDevStateNormalize(PnpState)
pCallback	Callback = EvtDevicePnpStateChange
pCallback	Types = CallbackTypes
return	STATUS_SUCCESS
_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_STATE	PowerState
_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_STATE __in PFN_WDF_DEVICE_POWER_STATE_CHANGE_NOTIFICATION	EvtDevicePowerStateChange
_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_POLICY_STATE	PowerPolicyState
_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_POLICY_STATE __in PFN_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION	EvtDevicePowerPolicyStateChange
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS	EvtDeviceWdmIrpPreprocess
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR	MajorFunction
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR __in_opt PUCHAR	MinorFunctions
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR __in_opt PUCHAR __in ULONG	NumMinorFunctions
DeviceInit PreprocessInfo Dispatch[MajorFunction]	EvtDevicePreprocess
__in PWDFDEVICE_INIT __in PFN_WDF_IO_IN_CALLER_CONTEXT	EvtIoInCallerContext
DeviceInit	IoInCallerContextCallback = EvtIoInCallerContext
	return
__in PWDFDEVICE_INIT __in PWDF_REMOVE_LOCK_OPTIONS	RemoveLockOptions
PFX_DRIVER_GLOBALS	fxDriverGlobals = GetFxDriverGlobals(DriverGlobals)
ULONG	validFlags = WDF_REMOVE_LOCK_OPTION_ACQUIRE_FOR_IO
DeviceInit	RemoveLockOptionFlags = RemoveLockOptions->Flags
Done	__pad0__
__in PWDFDEVICE_INIT __in WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE	ReleaseHardwareOrderOnFailure
DeviceInit	RequiresSelfIoTarget = TRUE
_Must_inspect_result_ __in PWDFDEVICE_INIT __in ULONG	DeviceInstanceKeyType
_Must_inspect_result_ __in PWDFDEVICE_INIT __in ULONG __in ACCESS_MASK	DesiredAccess
_Must_inspect_result_ __in PWDFDEVICE_INIT __in ULONG __in ACCESS_MASK __in_opt PWDF_OBJECT_ATTRIBUTES	KeyAttributes
_Must_inspect_result_ __in PWDFDEVICE_INIT __in ULONG __in ACCESS_MASK __in_opt PWDF_OBJECT_ATTRIBUTES __out WDFKEY *	Key
DeviceInit Fdo	Filter = TRUE
_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY	DeviceProperty
_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in ULONG	BufferLength
_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in ULONG __out PULONG	ResultLength
_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in __in_opt PWDF_OBJECT_ATTRIBUTES	PropertyMemoryAttributes
_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in __in_opt PWDF_OBJECT_ATTRIBUTES __out WDFMEMORY *	PropertyMemory
__in PWDFDEVICE_INIT __in PWDF_FDO_EVENT_CALLBACKS	FdoEventCallbacks
__inout PWDFDEVICE_INIT __in PWDF_CHILD_LIST_CONFIG	Config
__inout PWDFDEVICE_INIT __in PWDF_CHILD_LIST_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES	DefaultDeviceListAttributes
size_t	totalDescriptionSize = 0
_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ ULONG _Out_ PVOID	PropertyBuffer
_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ ULONG _Out_ PVOID _Out_ PULONG _Out_ PDEVPROPTYPE	Type
_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ _Strict_type_match_ POOL_TYPE	PoolType
_Must_inspect_result_ __in WDFDEVICE	ParentDevice
PWDFDEVICE_INIT	pInit = new(pFxDriverGlobals) WDFDEVICE_INIT(pDevice->GetDriver())
FxDevice *	pDevice
pInit Pdo	Static = TRUE
__in PWDFDEVICE_INIT __in PWDF_PDO_EVENT_CALLBACKS	DispatchTable
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING	DeviceID
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING	InstanceID
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING	HardwareID
FxString *	pID = new(pFxDriverGlobals, WDF_NO_OBJECT_ATTRIBUTES) FxString(pFxDriverGlobals)
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING	CompatibleID
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING	ContainerID
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING	DeviceDescription
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING __in PCUNICODE_STRING	DeviceLocation
_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING __in PCUNICODE_STRING __in LCID	LocaleId
FxDeviceText *	pDeviceText = new(pFxDriverGlobals, PagedPool) FxDeviceText()
pDeviceText	m_LocaleId = LocaleId
pDeviceText	m_Description
pDeviceText	m_LocationInformation
*DeviceInit Pdo	LastDeviceTextEntry = &pDeviceText->m_Entry
Done	__pad1__
DeviceInit Pdo	DefaultLocale = LocaleId
DeviceInit Pdo	Raw = TRUE
DeviceInit Pdo	ForwardRequestToParent = TRUE
_Must_inspect_result_ __in WDFDRIVER	Driver
FxDriver *	pDriver
__in PWDFDEVICE_INIT __in PFN_WDF_DEVICE_SHUTDOWN_NOTIFICATION	Notification
__in PWDFDEVICE_INIT __in PFN_WDF_DEVICE_SHUTDOWN_NOTIFICATION __in UCHAR	Flags
DeviceInit Control	ShutdownNotification = Notification

Typedef Documentation

PWDF_PDO_EVENT_CALLBACKS_V1_9

typedef struct _WDF_PDO_EVENT_CALLBACKS_V1_9 * PWDF_PDO_EVENT_CALLBACKS_V1_9

PWDF_PNPPOWER_EVENT_CALLBACKS_V1_9

typedef struct _WDF_PNPPOWER_EVENT_CALLBACKS_V1_9 * PWDF_PNPPOWER_EVENT_CALLBACKS_V1_9

PWDF_POWER_POLICY_EVENT_CALLBACKS_V1_5

typedef struct _WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5 * PWDF_POWER_POLICY_EVENT_CALLBACKS_V1_5

WDF_PDO_EVENT_CALLBACKS_V1_9

typedef struct _WDF_PDO_EVENT_CALLBACKS_V1_9 WDF_PDO_EVENT_CALLBACKS_V1_9

WDF_PNPPOWER_EVENT_CALLBACKS_V1_9

typedef struct _WDF_PNPPOWER_EVENT_CALLBACKS_V1_9 WDF_PNPPOWER_EVENT_CALLBACKS_V1_9

WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5

typedef struct _WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5 WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5

Function Documentation

__drv_maxIRQL() [1/2]

__drv_maxIRQL

(

DISPATCH_LEVEL

)

__drv_maxIRQL() [2/2]

_Must_inspect_result_ __drv_maxIRQL

(

PASSIVE_LEVEL

)

__drv_strictTypeMatch()

_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in __drv_strictTypeMatch

(

__drv_typeExpr

)

__drv_when()

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR __drv_when	(	NumMinorFunctions	,
		0	,
		__in_bcount(NumMinorFunctions)
	)

__out_bcount_full_opt()

_Must_inspect_result_ __in PWDFDEVICE_INIT __in DEVICE_REGISTRY_PROPERTY __in ULONG __out_bcount_full_opt

(

BufferLength

)

_IRQL_requires_max_() [1/2]

_IRQL_requires_max_

(

DISPATCH_LEVEL

)

Definition at line 347 of file common.c.

{
    NTSTATUS                    status;
    BOOLEAN                     requestSent = FALSE;
 
    BOOLEAN                     shouldRetry = TRUE;
    PCDB                        cdb = (PCDB)DeviceExtension->PowerContext.Srb.Cdb;
    ULONG                       timeoutValue = DeviceExtension->TimeOutValue;
    ULONG                       retryCount = 1;
 
    // reset some fields.
    DeviceExtension->PowerContext.RetryIntervalIn100ns = 0;
    status = PowerContextReuseRequest(DeviceExtension);
    RequestClearSendTime(DeviceExtension->PowerContext.PowerRequest);
 
    if (!NT_SUCCESS(status))
    {
        return status;
    }
 
    // set proper timeout value and max retry count.
    switch(DeviceExtension->PowerContext.PowerChangeState.PowerDown)
    {
    case PowerDownDeviceInitial:
    case PowerDownDeviceQuiesced:
    case PowerDownDeviceStopped:
        break;
 
    case PowerDownDeviceLocked:
        // Case of issuing SYNC CACHE command. Do not use power irp timeout remaining time in this case
        // as we want to give best try on SYNC CACHE command.
        retryCount = MAXIMUM_RETRIES;
        timeoutValue = DeviceExtension->TimeOutValue;
        break;
 
    case PowerDownDeviceFlushed:
    {
        // Case of issuing STOP UNIT command
        // As "Imme" bit is set to '1', this command should be completed in short time.
        // This command is at low importance, failure of this command has very small impact.
        ULONG secondsRemaining = 0;
 
#if (WINVER >= 0x0601)
        // this API is introduced in Windows7
        PoQueryWatchdogTime(DeviceExtension->LowerPdo, &secondsRemaining);
#endif
 
        if (secondsRemaining == 0)
        {
            // not able to retrieve remaining time from PoQueryWatchdogTime API, use default values.
            retryCount = MAXIMUM_RETRIES;
            timeoutValue = SCSI_CDROM_TIMEOUT;
        }
        else
        {
            // plan to leave about 30 seconds to lower level drivers if possible.
            if (secondsRemaining >= 32)
            {
                retryCount = (secondsRemaining - 30)/SCSI_CDROM_TIMEOUT + 1;
                timeoutValue = SCSI_CDROM_TIMEOUT;
 
                if (retryCount > MAXIMUM_RETRIES)
                {
                    retryCount = MAXIMUM_RETRIES;
                }
 
                if (retryCount == 1)
                {
                    timeoutValue = secondsRemaining - 30;
                }
            }
            else
            {
                // issue the command with minimal timeout value and do not retry on it.
                retryCount = 1;
                timeoutValue = 2;
            }
        }
    }
        break;
    default:
        NT_ASSERT( FALSE );
        status = STATUS_NOT_IMPLEMENTED;
        return status;
    }
 
    DeviceExtension->PowerContext.RetryCount = retryCount;
 
    // issue command.
    while (shouldRetry)
    {
 
        // set SRB fields.
        DeviceExtension->PowerContext.Srb.SrbFlags = SRB_FLAGS_NO_DATA_TRANSFER |
                                                     SRB_FLAGS_DISABLE_SYNCH_TRANSFER |
                                                     SRB_FLAGS_NO_QUEUE_FREEZE |
                                                     SRB_FLAGS_BYPASS_LOCKED_QUEUE |
                                                     SRB_FLAGS_D3_PROCESSING;
 
        DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_EXECUTE_SCSI;
        DeviceExtension->PowerContext.Srb.TimeOutValue = timeoutValue;
 
        if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceInitial)
        {
            DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_LOCK_QUEUE;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceLocked)
        {
            DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_QUIESCE_DEVICE;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceQuiesced)
        {
            // Case of issuing SYNC CACHE command.
            DeviceExtension->PowerContext.Srb.CdbLength = 10;
            cdb->SYNCHRONIZE_CACHE10.OperationCode = SCSIOP_SYNCHRONIZE_CACHE;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceFlushed)
        {
            // Case of issuing STOP UNIT command.
            DeviceExtension->PowerContext.Srb.CdbLength = 6;
            cdb->START_STOP.OperationCode = SCSIOP_START_STOP_UNIT;
            cdb->START_STOP.Start = 0;
            cdb->START_STOP.Immediate = 1;
        }
        else if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceStopped)
        {
            DeviceExtension->PowerContext.Srb.Function = SRB_FUNCTION_UNLOCK_QUEUE;
        }
 
        // Set up completion routine and context if requested
        if (CompletionRoutine)
        {
            WdfRequestSetCompletionRoutine(DeviceExtension->PowerContext.PowerRequest,
                                           CompletionRoutine,
                                           Context);
        }
 
        status = RequestSend(DeviceExtension,
                             DeviceExtension->PowerContext.PowerRequest,
                             DeviceExtension->IoTarget,
                             CompletionRoutine ? 0 : WDF_REQUEST_SEND_OPTION_SYNCHRONOUS,
                             &requestSent);
 
        if (requestSent)
        {
            if ((CompletionRoutine == NULL) &&
                (SRB_STATUS(DeviceExtension->PowerContext.Srb.SrbStatus) != SRB_STATUS_SUCCESS))
            {
                TracePrint((TRACE_LEVEL_ERROR,
                            TRACE_FLAG_POWER,
                            "%p\tError occured when issuing %s command to device. Srb %p, Status %x\n",
                            DeviceExtension->PowerContext.PowerRequest,
                            (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceQuiesced) ? "SYNC CACHE" : "STOP UNIT",
                            &DeviceExtension->PowerContext.Srb,
                            DeviceExtension->PowerContext.Srb.SrbStatus));
 
                NT_ASSERT(!(TEST_FLAG(DeviceExtension->PowerContext.Srb.SrbStatus, SRB_STATUS_QUEUE_FROZEN)));
 
                shouldRetry = RequestSenseInfoInterpret(DeviceExtension,
                                                        DeviceExtension->PowerContext.PowerRequest,
                                                        &(DeviceExtension->PowerContext.Srb),
                                                        retryCount - DeviceExtension->PowerContext.RetryCount,
                                                        &status,
                                                        &(DeviceExtension->PowerContext.RetryIntervalIn100ns));
 
                if (shouldRetry && (DeviceExtension->PowerContext.RetryCount-- == 0))
                {
                    shouldRetry = FALSE;
                }
            }
            else
            {
                // succeeded, do not need to retry.
                shouldRetry = FALSE;
            }
 
        }
        else
        {
            // request failed to be sent
            shouldRetry = FALSE;
        }
 
        if (shouldRetry)
        {
            LARGE_INTEGER t;
            t.QuadPart = -DeviceExtension->PowerContext.RetryIntervalIn100ns;
            KeDelayExecutionThread(KernelMode, FALSE, &t);
 
            status = PowerContextReuseRequest(DeviceExtension);
            if (!NT_SUCCESS(status))
            {
                shouldRetry = FALSE;
            }
        }
    }
 
    if (DeviceExtension->PowerContext.PowerChangeState.PowerDown == PowerDownDeviceQuiesced)
    {
        // record SYNC CACHE command completion time stamp.
        KeQueryTickCount(&DeviceExtension->PowerContext.Step1CompleteTime);
    }
 
    return status;
}

_IRQL_requires_max_() [2/2]

_IRQL_requires_max_

(

PASSIVE_LEVEL

)

Queries information details about a security descriptor.

Computes the quota size of a security descriptor.

Assigns a security descriptor for a new object.

An extended function that assigns a security descriptor for a new object.

Frees a security descriptor.

An extended function that sets new information data to a security descriptor.

Modifies some information data about a security descriptor.

Parameters

[in]	SecurityInformation	Security information details to be queried from a security descriptor.
[out]	SecurityDescriptor	The returned security descriptor with security information data.
[in,out]	Length	The returned length of a security descriptor.
[in,out]	ObjectsSecurityDescriptor	The returned object security descriptor.

Returns

Returns STATUS_SUCCESS if the operations have been completed successfully and that the specific information about the security descriptor has been queried. STATUS_BUFFER_TOO_SMALL is returned if the buffer size is too small to contain the queried info about the security descriptor.

Parameters

[in]	Object	If specified, the function will use this arbitrary object that points to an object security descriptor.
[in]	SecurityInformation	Security information details to be set.
[in]	SecurityDescriptor	A security descriptor where its info is to be changed.
[in,out]	ObjectsSecurityDescriptor	The returned pointer to security descriptor objects.
[in]	PoolType	Pool type for the new security descriptor to allocate.
[in]	GenericMapping	The generic mapping of access rights masks.

Returns

See SeSetSecurityDescriptorInfoEx.

Parameters

[in]	Object	If specified, the function will use this arbitrary object that points to an object security descriptor.
[in]	SecurityInformation	Security information details to be set.
[in]	SecurityDescriptor	A security descriptor where its info is to be changed.
[in,out]	ObjectsSecurityDescriptor	The returned pointer to security descriptor objects.
[in]	AutoInheritFlags	Flags bitmask inheritation, influencing how the security descriptor can be inherited and if it can be in the first place.
[in]	PoolType	Pool type for the new security descriptor to allocate.
[in]	GenericMapping	The generic mapping of access rights masks.

Returns

Returns STATUS_SUCCESS if the operations have been completed without problems and that new info has been set to the security descriptor. STATUS_NO_SECURITY_ON_OBJECT is returned if the object does not have a security descriptor. STATUS_INSUFFICIENT_RESOURCES is returned if memory pool allocation for the new security descriptor with new info set has failed.

Parameters

[in]

SecurityDescriptor

A security descriptor to be freed from memory.

Returns

Returns STATUS_SUCCESS.

Parameters

[in]	_ParentDescriptor	A security descriptor of the parent object that is being created.
[in]	_ExplicitDescriptor	An explicit security descriptor that is applied to a new object.
[out]	NewDescriptor	The new allocated security descriptor.
[in]	ObjectType	The type of the new object.
[in]	IsDirectoryObject	Set this to TRUE if the newly created object is a directory object, otherwise set this to FALSE.
[in]	AutoInheritFlags	Automatic inheritance flags that influence how access control entries within ACLs from security descriptors are inherited.
[in]	SubjectContext	Security subject context of the new object.
[in]	GenericMapping	Generic mapping of access mask rights.
[in]	PoolType	This parameter is unused.

Returns

Returns STATUS_SUCCESS if the operations have been completed successfully and that the security descriptor has been assigned to the new object. STATUS_NO_TOKEN is returned if the caller hasn't supplied a valid argument to a security subject context. STATUS_INVALID_OWNER is returned if the caller hasn't supplied a parent descriptor that belongs to the main user (owner). STATUS_INVALID_PRIMARY_GROUP is returned by the same reason as with the previous NTSTATUS code. The two NTSTATUS codes are returned if the calling thread stated that the owner and/or group is defaulted to the parent descriptor (SEF_DEFAULT_OWNER_FROM_PARENT and/or SEF_DEFAULT_GROUP_FROM_PARENT respectively). STATUS_INSUFFICIENT_RESOURCES is returned if memory pool allocation for the descriptor buffer has failed. A failure NTSTATUS is returned otherwise.

Parameters

[in]	ParentDescriptor	A security descriptor of the parent object that is being created.
[in]	ExplicitDescriptor	An explicit security descriptor that is applied to a new object.
[out]	NewDescriptor	The new allocated security descriptor.
[in]	IsDirectoryObject	Set this to TRUE if the newly created object is a directory object, otherwise set this to FALSE.
[in]	SubjectContext	Security subject context of the new object.
[in]	GenericMapping	Generic mapping of access mask rights.
[in]	PoolType	This parameter is unused.

Returns

See SeAssignSecurityEx.

Parameters

[in]	SecurityDescriptor	A security descriptor.
[out]	QuotaInfoSize	The returned quota size of the given security descriptor to the caller. The function may return 0 to this parameter if the descriptor doesn't have a group or a discretionary access control list (DACL) even.

Returns

Returns STATUS_SUCCESS if the quota size of a security descriptor has been computed successfully. STATUS_UNKNOWN_REVISION is returned if the security descriptor has an invalid revision.

Definition at line 923 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;
}

Assign()

return DeviceInit Security Sddl Assign

(

SDDLString

)

AssignIoType()

DeviceInit AssignIoType

(

IoTypeConfig

)

AssignName()

return DeviceInit AssignName	(	DeviceInit->	DriverGlobals,
		DeviceName
	)

DeviceInit() [1/6]

RtlCopyMemory & DeviceInit

(

DeviceInit->Fdo.

EventCallbacks

)

DeviceInit() [2/6]

RtlCopyMemory & DeviceInit

(

DeviceInit->FileObject.

Callbacks

)

DeviceInit() [3/6]

RtlCopyMemory & DeviceInit

(

GUID

)

DeviceInit() [4/6]

RtlCopyMemory & DeviceInit

(

WDF_CHILD_LIST_CONFIG

)

DeviceInit() [5/6]

RtlCopyMemory & DeviceInit

(

WDF_OBJECT_ATTRIBUTES

)

DeviceInit() [6/6]

RtlCopyMemory & DeviceInit

(

WDF_PDO_EVENT_CALLBACKS

)

FxObjectHandleGetPtrAndGlobals() [1/2]

FxObjectHandleGetPtrAndGlobals	(	GetFxDriverGlobals(DriverGlobals)	,
		Driver	,
		FX_TYPE_DRIVER	,
		(PVOID *) &	pDriver,
		&	pFxDriverGlobals
	)

FxObjectHandleGetPtrAndGlobals() [2/2]

FxObjectHandleGetPtrAndGlobals	(	GetFxDriverGlobals(DriverGlobals)	,
		ParentDevice	,
		FX_TYPE_DEVICE	,
		(PVOID *) &	pDevice,
		&	pFxDriverGlobals
	)

FxPointerNotNull() [1/25]

FxPointerNotNull	(	fxDriverGlobals	,
		DeviceInit
	)

FxPointerNotNull() [2/25]

FxPointerNotNull	(	fxDriverGlobals	,
		RemoveLockOptions
	)

FxPointerNotNull() [3/25]

FxPointerNotNull	(	GetFxDriverGlobals(DriverGlobals)	,
		DeviceInit
	)

FxPointerNotNull() [4/25]

FxPointerNotNull	(	GetFxDriverGlobals(DriverGlobals)	,
		EvtIoInCallerContext
	)

FxPointerNotNull() [5/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		Config
	)

FxPointerNotNull() [6/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		DeviceClassGuid
	)

FxPointerNotNull() [7/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		DeviceID
	)

FxPointerNotNull() [8/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		DeviceInit
	)

FxPointerNotNull() [9/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		DeviceLocation
	)

FxPointerNotNull() [10/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		DeviceProperty
	)

FxPointerNotNull() [11/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		DispatchTable
	)

FxPointerNotNull() [12/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		EvtDevicePnpStateChange
	)

FxPointerNotNull() [13/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		EvtDevicePowerPolicyStateChange
	)

FxPointerNotNull() [14/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		EvtDevicePowerStateChange
	)

FxPointerNotNull() [15/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		EvtDeviceWdmIrpPreprocess
	)

FxPointerNotNull() [16/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		FdoEventCallbacks
	)

FxPointerNotNull() [17/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		FileObjectConfig
	)

FxPointerNotNull() [18/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		Key
	)

FxPointerNotNull() [19/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		Notification
	)

FxPointerNotNull() [20/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		PnpPowerEventCallbacks
	)

FxPointerNotNull() [21/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		PowerPolicyEventCallbacks
	)

FxPointerNotNull() [22/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		PropertyMemory
	)

FxPointerNotNull() [23/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		RequestAttributes
	)

FxPointerNotNull() [24/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		ResultLength
	)

FxPointerNotNull() [25/25]

FxPointerNotNull	(	pFxDriverGlobals	,
		SDDLString
	)

FxVerifierCheckNxPoolType()

FxVerifierCheckNxPoolType	(	pFxDriverGlobals	,
		PoolType	,
		pFxDriverGlobals->	Tag
	)

if() [1/45]

if

(

!

NT_SUCCESSFxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL)

)

Definition at line 1480 of file fxdeviceinitapi.cpp.

                                                              {
        return;
    }

if() [2/45]

if

(

!

NT_SUCCESSstatus

)

Definition at line 329 of file fxdeviceinitapi.cpp.

                             {
        return status;
    }

if() [3/45]

if

(

(CallbackTypes &~StateNotificationAllStates) !

= 0 || CallbackTypes == 0x0

)

Definition at line 890 of file fxdeviceinitapi.cpp.

                              {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "CallbackTypes is invalid %!STATUS!", status);
 
        return status;
    }

if() [4/45]

if

(

(DeviceCharacteristics &FILE_AUTOGENERATED_DEVICE_NAME) &&DeviceInit->DeviceName !

= NULL

)

Definition at line 389 of file fxdeviceinitapi.cpp.

                                        {
        DeviceInit->DeviceName->RELEASE(NULL);
        DeviceInit->DeviceName = NULL;
    }

if() [5/45]

if

(

(Flags &~(WdfDeviceShutdown|WdfDeviceLastChanceShutdown)) !

= 0

)

Definition at line 2743 of file fxdeviceinitapi.cpp.

                                                                           {
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "WdfDeviceShutdown Flags 0x%x are invalid", Flags);
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [6/45]

if

(

(ReleaseHardwareOrderOnFailure== WdfReleaseHardwareOrderOnFailureInvalid)||(ReleaseHardwareOrderOnFailure > WdfReleaseHardwareOrderOnFailureAfterDescendants)

)

Definition at line 1327 of file fxdeviceinitapi.cpp.

                                                               {
        DoTraceLevelMessage(
            DeviceInit->DriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Out of range WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE %d",
            ReleaseHardwareOrderOnFailure);
        FxVerifierDbgBreakPoint(DeviceInit->DriverGlobals);
        return;
    }

if() [7/45]

if

(

(RemoveLockOptions->Flags &~validFlags) !

= 0

)

Definition at line 1280 of file fxdeviceinitapi.cpp.

                                                       {
        //
        // Invalid flag
        //
        DoTraceLevelMessage(fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGAPIERROR,
                            "RemoveLockOptions %p Flags 0x%x invalid, "
                            "valid mask is 0x%x",
                            RemoveLockOptions, RemoveLockOptions->Flags,
                            validFlags);
 
        FxVerifierDbgBreakPoint(fxDriverGlobals);
        goto Done;
    }

if() [8/45]

if	(	BufferLength	,
		0
	)

Definition at line 1545 of file fxdeviceinitapi.cpp.

                          {
        FxPointerNotNull(pFxDriverGlobals, PropertyBuffer);
    }

if() [9/45]

if

(

DefaultDeviceListAttributes !

= NULL

)

Definition at line 1766 of file fxdeviceinitapi.cpp.

                                             {
        status = FxValidateObjectAttributes(pFxDriverGlobals,
                                            DefaultDeviceListAttributes,
                                            FX_VALIDATE_OPTION_PARENT_NOT_ALLOWED);
        if (!NT_SUCCESS(status)) {
            FxVerifierDbgBreakPoint(pFxDriverGlobals);
            return;
        }
 
        RtlCopyMemory(&DeviceInit->Fdo.ListConfigAttributes,
                      DefaultDeviceListAttributes,
                      sizeof(DeviceInit->Fdo.ListConfigAttributes));
    }

if() [10/45]

if

(

DeviceInit->

CreatedOnStack = = FALSE

)

Definition at line 152 of file fxdeviceinitapi.cpp.

                                             {
        delete DeviceInit;
    }

if() [11/45]

if

(

DeviceInit->

IsNotFdoInit()

)

Definition at line 1398 of file fxdeviceinitapi.cpp.

                                    {
        DoTraceLevelMessage(
            DeviceInit->DriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Not a PWDFDEVICE_INIT for an FDO"
            );
 
        return NULL;
    }

if() [12/45]

if

(

DeviceInit->Pdo.

DeviceID = = NULL

)

Definition at line 2173 of file fxdeviceinitapi.cpp.

                                          {
        DeviceInit->Pdo.DeviceID = new(pFxDriverGlobals, WDF_NO_OBJECT_ATTRIBUTES)
            FxString(pFxDriverGlobals);
 
        if (DeviceInit->Pdo.DeviceID == NULL) {
            status = STATUS_INSUFFICIENT_RESOURCES;
            DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "Couldn't allocate DeviceID object, %!STATUS!",
                            status);
            return status;
        }
    }

if() [13/45]

if

(

DeviceInit->PnpPower.

PnpStateCallbacks = = NULL

)

Definition at line 900 of file fxdeviceinitapi.cpp.

                                                        {
 
        DeviceInit->PnpPower.PnpStateCallbacks =
            new (pFxDriverGlobals) FxPnpStateCallback();
 
        if (DeviceInit->PnpPower.PnpStateCallbacks == NULL) {
            status = STATUS_INVALID_PARAMETER;
 
            DoTraceLevelMessage(
                pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "Couldn't create object PnpStateCallbacks %!STATUS!", status);
 
            return status;
        }
    }

if() [14/45]

if

(

DeviceInit->Security.

Sddl = = NULL

)

Definition at line 655 of file fxdeviceinitapi.cpp.

                                           {
        DeviceInit->Security.Sddl = new(pFxDriverGlobals,
                                        WDF_NO_OBJECT_ATTRIBUTES)
            FxString(pFxDriverGlobals);
 
        if (DeviceInit->Security.Sddl == NULL) {
             DoTraceLevelMessage(
                 pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                 "Couldn't create Security descriptor"
                 " STATUS_INSUFFICIENT_RESOURCES ");
 
             return STATUS_INSUFFICIENT_RESOURCES;
        }
    }

if() [15/45]

if

(

DeviceName !

= NULL

)

Definition at line 333 of file fxdeviceinitapi.cpp.

                            {
        status = FxValidateUnicodeString(DeviceInit->DriverGlobals,
                                         DeviceName);
        if (!NT_SUCCESS(status)) {
            return status;
        }
    }

if() [16/45]

if

(

DeviceName

= = NULL

)

Definition at line 341 of file fxdeviceinitapi.cpp.

                            {
        if (DeviceInit->DeviceName != NULL) {
            DeviceInit->DeviceName->RELEASE(NULL);
            DeviceInit->DeviceName = NULL;
        }
 
        if (DeviceInit->IsPdoInit()) {
            //
            // Make sure a PDO has a name
            //
            DeviceInit->Characteristics |= FILE_AUTOGENERATED_DEVICE_NAME;
        }
 
        return STATUS_SUCCESS;
    }

if() [17/45]

if

(

DeviceProperty->Size !

= sizeof(WDF_DEVICE_PROPERTY_DATA)

)

Definition at line 1864 of file fxdeviceinitapi.cpp.

                                                                  {
        status = STATUS_INFO_LENGTH_MISMATCH;
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP,
                     "PropertyData size (%d) incorrect, expected %d, %!STATUS!",
                     DeviceProperty->Size,
                     sizeof(WDF_DEVICE_PROPERTY_DATA), status);
        return status;
    }

if() [18/45]

if

(

DispatchTable->Size !

= sizeof(WDF_PDO_EVENT_CALLBACKS) && DispatchTable->Size != sizeof(WDF_PDO_EVENT_CALLBACKS_V1_9)

)

Definition at line 2118 of file fxdeviceinitapi.cpp.

                                                                     {
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "DispatchTable size %d is invalid, expected %d",
                            DispatchTable->Size, sizeof(WDF_PDO_EVENT_CALLBACKS));
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return; // STATUS_INFO_LENGTH_MISMATCH;
    }

if() [19/45]

if

(

FdoEventCallbacks->EvtDeviceFilterAddResourceRequirements !

= NULL && FdoEventCallbacks->EvtDeviceRemoveAddedResources == NULL

)

Definition at line 1700 of file fxdeviceinitapi.cpp.

                                                                  {
        //
        // Not allowed to add resources without filtering them out later
        //
        DoTraceLevelMessage(
            GetFxDriverGlobals(DriverGlobals), TRACE_LEVEL_ERROR, TRACINGPNP,
            "Must set EvtDeviceRemoveAddedResources if "
            "EvtDeviceFilterAddResourceRequirements (%p) is set",
            FdoEventCallbacks->EvtDeviceFilterAddResourceRequirements);
 
        FxVerifierDbgBreakPoint(GetFxDriverGlobals(DriverGlobals));
        return;
    }

if() [20/45]

if

(

FdoEventCallbacks->Size !

= sizeof(WDF_FDO_EVENT_CALLBACKS)

)

Definition at line 1690 of file fxdeviceinitapi.cpp.

                                                                    {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "FdoEventCallbacks size %d is invalid, expected %d",
            FdoEventCallbacks->Size, sizeof(WDF_FDO_EVENT_CALLBACKS)
            );
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [21/45]

if

(

FileObjectAttributes !

= NULL

)

Definition at line 560 of file fxdeviceinitapi.cpp.

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

if() [22/45]

if

(

FileObjectConfig->Size !

= sizeof(WDF_FILEOBJECT_CONFIG)

)

Definition at line 437 of file fxdeviceinitapi.cpp.

                                                                 {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Invalid FileObjectConfig Size %d, expected %d",
            FileObjectConfig->Size, sizeof(WDF_FILEOBJECT_CONFIG));
 
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [23/45]

if

(

FxDeviceInitTypeControlDevice

= = DeviceInit->InitType

)

Definition at line 1294 of file fxdeviceinitapi.cpp.

                                                               {
        //
        // At this time this feature is not supported on control-devices.
        //
        DoTraceLevelMessage(fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGAPIERROR,
                            "WdfDeviceInitSetRemoveLockOptions is not "
                            "supported on control devices");
 
        FxVerifierDbgBreakPoint(fxDriverGlobals);
        goto Done;
    }

if() [24/45]

if

(

FxIsFileObjectOptional(fileClass)

)

Definition at line 536 of file fxdeviceinitapi.cpp.

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

if() [25/45]

if

(

IoTypeConfig->Size !

= sizeof(WDF_IO_TYPE_CONFIG)

)

Definition at line 203 of file fxdeviceinitapi.cpp.

                                                          {
        status = STATUS_INFO_LENGTH_MISMATCH;
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGPNP,
                     "IoTypeConfig size (%d) incorrect, expected %d, %!STATUS!",
                     IoTypeConfig->Size,
                     sizeof(WDF_IO_TYPE_CONFIG), status);
        return;
    }

if() [26/45]

if

(

MajorFunction >=

ARRAY_SIZEDeviceInit->PreprocessInfo->Dispatch

)

Definition at line 1125 of file fxdeviceinitapi.cpp.

                                                                           {
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "MajorFunction is invalid"
                            "STATUS_INVALID_PARAMETER"
                            );
 
        return STATUS_INVALID_PARAMETER;
    }

if() [27/45]

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

Definition at line 491 of file fxdeviceinitapi.cpp.

                                                                    {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Out of range FileObjectConfig->FileObjectClass %d",
            fileClass);
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [28/45]

if

(

normalizedState< WdfDevStatePnpObjectCreated||normalizedState >

WdfDevStatePnpNull

)

Definition at line 881 of file fxdeviceinitapi.cpp.

                                                                                               {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "Pnp State is invalid %!STATUS!", status);
 
        return status;
    }

if() [29/45]

if

(

normalizedState< WdfDevStatePowerObjectCreated||normalizedState >

= WdfDevStatePowerNull

)

Definition at line 961 of file fxdeviceinitapi.cpp.

                                                 {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "PowerState State is invalid %!STATUS!", status);
 
        return status;
    }

if() [30/45]

if

(

normalizedState< WdfDevStatePwrPolObjectCreated||normalizedState >

= WdfDevStatePwrPolNull

)

Definition at line 1042 of file fxdeviceinitapi.cpp.

                                                  {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "PowerPolicyState State is invalid %!STATUS!", status);
 
        return status;
    }

if() [31/45]

if

(

NT_SUCCESS(status)

)

Definition at line 2302 of file fxdeviceinitapi.cpp.

                            {
        status = (DeviceInit->Pdo.HardwareIDs.Add(pFxDriverGlobals, pID)) ?
            STATUS_SUCCESS : STATUS_UNSUCCESSFUL;
    }

if() [32/45]

if	(	NumMinorFunctions	,
		0
	)

Definition at line 1117 of file fxdeviceinitapi.cpp.

                               {
        FxPointerNotNull(pFxDriverGlobals, MinorFunctions);
    }

if() [33/45]

if

(

OrInValues

)

Definition at line 379 of file fxdeviceinitapi.cpp.

                    {
        DeviceInit->Characteristics |= DeviceCharacteristics | FILE_DEVICE_SECURE_OPEN;
    }

if() [34/45]

if

(

pDevice->

IsFdo() = = FALSE

)

Definition at line 2058 of file fxdeviceinitapi.cpp.

                                   {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Parent device is not a FDO (must use WDFCHILDLIST to use a PDO as a parent)"
            );
 
        return NULL;
    }

if() [35/45]

if

(

pDeviceText->

m_Description = = NULL

)

Definition at line 2511 of file fxdeviceinitapi.cpp.

                                            {
        status = STATUS_INSUFFICIENT_RESOURCES;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Couldn't allocate DeviceDescription string, %!STATUS!", status);
 
        goto Done;
    }

if() [36/45]

if

(

pDeviceText

= = NULL

)

Definition at line 2496 of file fxdeviceinitapi.cpp.

                             {
        status = STATUS_INSUFFICIENT_RESOURCES;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Couldn't allocate DeviceText object, %!STATUS!", status);
 
        return status;
    }

if() [37/45]

if

(

pFxDriverGlobals->IsUserModeDriver &&

normalizedFileClass==WdfFileObjectWdfCanUseFsContext|| normalizedFileClass==WdfFileObjectWdfCanUseFsContext2

)

Definition at line 505 of file fxdeviceinitapi.cpp.

                                                                   {
 
        //
        // update the FileObjectClass value
        //
        BOOLEAN canBeOptional =
            (fileClass & WdfFileObjectCanBeOptional) ? TRUE : FALSE;
 
        fileClass = WdfFileObjectWdfCannotUseFsContexts;
        if (canBeOptional) {
            fileClass = (WDF_FILEOBJECT_CLASS)
                (fileClass | WdfFileObjectCanBeOptional);
        }
 
        DoTraceLevelMessage(
             pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGDEVICE,
             "FileObjectConfig->FileObjectClass value (%d) has been updated"
             " to a UMDF-supported value %d", normalizedFileClass,
             WdfFileObjectWdfCannotUseFsContexts);
 
        //
        // re-obtain the normalized class
        //
        normalizedFileClass = FxFileObjectClassNormalize(fileClass);
    }

if() [38/45]

if

(

pID

= = NULL

)

Definition at line 2293 of file fxdeviceinitapi.cpp.

                     {
        status = STATUS_INSUFFICIENT_RESOURCES;
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Couldn't allocate String object %!STATUS!", status);
        return status;
    }

if() [39/45]

if

(

pInit

= = NULL

)

Definition at line 2068 of file fxdeviceinitapi.cpp.

                       {
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "Couldn't create WDFDEVICE_INIT object");
 
        return NULL;
    }

if() [40/45]

if

(

PnpPowerEventCallbacks->Size !

= sizeof(WDF_PNPPOWER_EVENT_CALLBACKS) && PnpPowerEventCallbacks->Size != sizeof(_WDF_PNPPOWER_EVENT_CALLBACKS_V1_9)

)

Definition at line 721 of file fxdeviceinitapi.cpp.

                                                                                    {
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "PnpPowerEventCallbacks size %d is invalid, exptected %d",
            PnpPowerEventCallbacks->Size, sizeof(WDF_PNPPOWER_EVENT_CALLBACKS)
            );
 
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
 
        return;
    }

if() [41/45]

if	(	PnpPowerEventCallbacks->	Size,
		sizeof(WDF_PNPPOWER_EVENT_CALLBACKS_V1_9) &&PnpPowerEventCallbacks->EvtDeviceUsageNotification !	= NULL && PnpPowerEventCallbacks->EvtDeviceUsageNotificationEx != NULL
	)

Definition at line 739 of file fxdeviceinitapi.cpp.

                                                                      {
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Driver can provide either EvtDeviceUsageNotification or "
            "EvtDeviceUsageNotificationEx callback but not both");
 
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
 
        return;
    }

if() [42/45]

if

(

PowerPolicyEventCallbacks->Size !

= sizeof(WDF_POWER_POLICY_EVENT_CALLBACKS) && PowerPolicyEventCallbacks->Size != sizeof(WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5)

)

Definition at line 791 of file fxdeviceinitapi.cpp.

                                                                                          {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "PowerPolicyEventCallbacks size %d is invalid, expected %d",
            PowerPolicyEventCallbacks->Size, sizeof(WDF_POWER_POLICY_EVENT_CALLBACKS)
            );
 
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [43/45]

if	(	PowerPolicyEventCallbacks->	Size,
		sizeof(WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5) &&PowerPolicyEventCallbacks->EvtDeviceArmWakeFromSx !	= NULL && PowerPolicyEventCallbacks->EvtDeviceArmWakeFromSxWithReason != NULL
	)

Definition at line 808 of file fxdeviceinitapi.cpp.

                                                                             {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "PowerPolicyEventCallbacks can have either EvtDeviceArmWakeFromSx "
            "or EvtDeviceArmWakeFromSxWithReason callback pointer, but not both"
            );
 
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [44/45]

if

(

RemoveLockOptions->Size !

= sizeof(WDF_REMOVE_LOCK_OPTIONS)

)

Definition at line 1266 of file fxdeviceinitapi.cpp.

                                                                    {
        //
        // Size is wrong, bail out
        //
        DoTraceLevelMessage(fxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGAPIERROR,
                            "RemoveLockOptions %p Size incorrect, expected %d, "
                            "got %d",
                            RemoveLockOptions, sizeof(WDF_REMOVE_LOCK_OPTIONS),
                            RemoveLockOptions->Size);
 
        FxVerifierDbgBreakPoint(fxDriverGlobals);
        goto Done;
    }

if() [45/45]

if

(

SDDLString

= = NULL

)

Definition at line 633 of file fxdeviceinitapi.cpp.

                            {
        //
        // Since we require the SDDL on control device creation, you can't
        // clear it!
        //
        if (DeviceInit->IsControlDeviceInit()) {
            return STATUS_INVALID_DEVICE_REQUEST;
        }
 
        if (DeviceInit->Security.Sddl != NULL) {
            DeviceInit->Security.Sddl->RELEASE(NULL);
            DeviceInit->Security.Sddl = NULL;
        }
 
        return STATUS_SUCCESS;
    }

reinterpret_cast< PDEVICE_OBJECT >()

return reinterpret_cast< PDEVICE_OBJECT >

(

DeviceInit->Fdo.

PhysicalDevice

)

Release()

pID Release

(

)

Definition at line 919 of file cdrom.h.

SetPdo()

pInit SetPdo

(

pDevice

)

switch()

switch

(

FileObjectConfig->

AutoForwardCleanupClose

)

Definition at line 463 of file fxdeviceinitapi.cpp.

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

Variable Documentation

__pad0__

Done __pad0__

Definition at line 1307 of file fxdeviceinitapi.cpp.

__pad1__

Done __pad1__

Definition at line 2540 of file fxdeviceinitapi.cpp.

AutoForwardCleanupClose

DeviceInit FileObject AutoForwardCleanupClose

Initial value:

=
        FileObjectConfig->AutoForwardCleanupClose

Definition at line 481 of file fxdeviceinitapi.cpp.

BufferLength

_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ ULONG BufferLength

Definition at line 1508 of file fxdeviceinitapi.cpp.

Callback

pCallback Callback = EvtDevicePnpStateChange

Definition at line 919 of file fxdeviceinitapi.cpp.

CallbackTypes

_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_POLICY_STATE __in PFN_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION __in ULONG CallbackTypes

Initial value:

{
    DDI_ENTRY()

Definition at line 859 of file fxdeviceinitapi.cpp.

Class

DeviceInit FileObject Class = fileClass

Definition at line 554 of file fxdeviceinitapi.cpp.

CompatibleID

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING CompatibleID

Initial value:

{
    DDI_ENTRY()

Definition at line 2326 of file fxdeviceinitapi.cpp.

Config

__inout PWDFDEVICE_INIT __in PWDF_CHILD_LIST_CONFIG Config

Definition at line 1729 of file fxdeviceinitapi.cpp.

ContainerID

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING ContainerID

Initial value:

{
    DDI_ENTRY()

Definition at line 2392 of file fxdeviceinitapi.cpp.

DefaultDeviceListAttributes

__inout PWDFDEVICE_INIT __in PWDF_CHILD_LIST_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES DefaultDeviceListAttributes

Initial value:

{
    DDI_ENTRY()

Definition at line 1731 of file fxdeviceinitapi.cpp.

Referenced by if().

DefaultLocale

DeviceInit Pdo DefaultLocale = LocaleId

Definition at line 2580 of file fxdeviceinitapi.cpp.

DesiredAccess

_Must_inspect_result_ __in PWDFDEVICE_INIT __in ULONG __in ACCESS_MASK DesiredAccess

Definition at line 1422 of file fxdeviceinitapi.cpp.

DeviceCharacteristics

__in PWDFDEVICE_INIT __in ULONG DeviceCharacteristics

Definition at line 370 of file fxdeviceinitapi.cpp.

DeviceClassGuid

_Must_inspect_result_ __in PWDFDEVICE_INIT __in CONST GUID* DeviceClassGuid

Initial value:

{
    DDI_ENTRY()

Definition at line 682 of file fxdeviceinitapi.cpp.

DeviceClassSet

DeviceInit Security DeviceClassSet = TRUE

Definition at line 694 of file fxdeviceinitapi.cpp.

DeviceDescription

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING DeviceDescription

Definition at line 2453 of file fxdeviceinitapi.cpp.

DeviceID

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING DeviceID

Initial value:

{
    DDI_ENTRY()

Definition at line 2142 of file fxdeviceinitapi.cpp.

DeviceInit

__in PWDFDEVICE_INIT DeviceInit

Initial value:

{
    DDI_ENTRY()

Definition at line 145 of file fxdeviceinitapi.cpp.

Referenced by if().

DeviceInstanceKeyType

_Must_inspect_result_ __in PWDFDEVICE_INIT __in ULONG DeviceInstanceKeyType

Definition at line 1420 of file fxdeviceinitapi.cpp.

DeviceLocation

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING __in PCUNICODE_STRING DeviceLocation

Definition at line 2455 of file fxdeviceinitapi.cpp.

DeviceName

_Must_inspect_result_ __in PWDFDEVICE_INIT __in_opt PCUNICODE_STRING DeviceName

Initial value:

{
    DDI_ENTRY()

Definition at line 318 of file fxdeviceinitapi.cpp.

DeviceProperty

_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA DeviceProperty

Definition at line 1506 of file fxdeviceinitapi.cpp.

DeviceType

DeviceInit DeviceType

Initial value:

{
    DDI_ENTRY()

Definition at line 243 of file fxdeviceinitapi.cpp.

DispatchTable

__in PWDFDEVICE_INIT __in PWDF_PDO_EVENT_CALLBACKS DispatchTable

Initial value:

{
    DDI_ENTRY()

Definition at line 2095 of file fxdeviceinitapi.cpp.

Driver

_Must_inspect_result_ __in WDFDRIVER Driver

Definition at line 2681 of file fxdeviceinitapi.cpp.

else

else

Initial value:

{
        DeviceInit->Characteristics = DeviceCharacteristics | FILE_DEVICE_SECURE_OPEN

Definition at line 382 of file fxdeviceinitapi.cpp.

EvtDevicePnpStateChange

_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_PNP_STATE __in PFN_WDF_DEVICE_PNP_STATE_CHANGE_NOTIFICATION EvtDevicePnpStateChange

Definition at line 857 of file fxdeviceinitapi.cpp.

EvtDevicePowerPolicyStateChange

_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_POLICY_STATE __in PFN_WDF_DEVICE_POWER_POLICY_STATE_CHANGE_NOTIFICATION EvtDevicePowerPolicyStateChange

Definition at line 1018 of file fxdeviceinitapi.cpp.

EvtDevicePowerStateChange

_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_STATE __in PFN_WDF_DEVICE_POWER_STATE_CHANGE_NOTIFICATION EvtDevicePowerStateChange

Definition at line 937 of file fxdeviceinitapi.cpp.

EvtDevicePreprocess

DeviceInit PreprocessInfo Dispatch [MajorFunction] EvtDevicePreprocess

Initial value:

=
        EvtDeviceWdmIrpPreprocess

Definition at line 1183 of file fxdeviceinitapi.cpp.

EvtDeviceWdmIrpPreprocess

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS EvtDeviceWdmIrpPreprocess

Definition at line 1098 of file fxdeviceinitapi.cpp.

EvtIoInCallerContext

__in PWDFDEVICE_INIT __in PFN_WDF_IO_IN_CALLER_CONTEXT EvtIoInCallerContext

Initial value:

{
    DDI_ENTRY()

Definition at line 1199 of file fxdeviceinitapi.cpp.

Exclusive

DeviceInit Exclusive

Initial value:

{
    DDI_ENTRY()

Definition at line 224 of file fxdeviceinitapi.cpp.

Referenced by AfdSelect(), CcpPinMappedData(), FsRtlAcquireFileForModWriteEx(), IoCreateDevice(), KsAcquireDeviceSecurityLock(), Mx::MxCreateDevice(), Mx::MxCreateDeviceSecure(), ObpIncrementHandleCount(), ObpIncrementUnnamedHandleCount(), RtlEnterHeapLock(), RtlTryEnterHeapLock(), and WCacheStartDirect__().

FdoEventCallbacks

__in PWDFDEVICE_INIT __in PWDF_FDO_EVENT_CALLBACKS FdoEventCallbacks

Initial value:

{
    DDI_ENTRY()

Definition at line 1667 of file fxdeviceinitapi.cpp.

fileClass

fileClass = FileObjectConfig->FileObjectClass

Definition at line 430 of file fxdeviceinitapi.cpp.

Referenced by if().

FileObjectAttributes

__in PWDFDEVICE_INIT __in PWDF_FILEOBJECT_CONFIG __in_opt PWDF_OBJECT_ATTRIBUTES FileObjectAttributes

Initial value:

{
    DDI_ENTRY()

Definition at line 407 of file fxdeviceinitapi.cpp.

FileObjectConfig

__in PWDFDEVICE_INIT __in PWDF_FILEOBJECT_CONFIG FileObjectConfig

Definition at line 405 of file fxdeviceinitapi.cpp.

Filter

DeviceInit Fdo Filter = TRUE

Definition at line 1493 of file fxdeviceinitapi.cpp.

Flags

DeviceInit Control Flags

Initial value:

{
    DDI_ENTRY()

Definition at line 2724 of file fxdeviceinitapi.cpp.

ForwardRequestToParent

DeviceInit Pdo ForwardRequestToParent = TRUE

Definition at line 2659 of file fxdeviceinitapi.cpp.

fxDriverGlobals

PFX_DRIVER_GLOBALS fxDriverGlobals = GetFxDriverGlobals(DriverGlobals)

Definition at line 1259 of file fxdeviceinitapi.cpp.

Referenced by if().

HardwareID

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING HardwareID

Initial value:

{
    DDI_ENTRY()

Definition at line 2260 of file fxdeviceinitapi.cpp.

Inrush

DeviceInit Inrush = TRUE

Definition at line 304 of file fxdeviceinitapi.cpp.

InstanceID

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PCUNICODE_STRING InstanceID

Initial value:

{
    DDI_ENTRY()

Definition at line 2201 of file fxdeviceinitapi.cpp.

IoInCallerContextCallback

DeviceInit IoInCallerContextCallback = EvtIoInCallerContext

Definition at line 1240 of file fxdeviceinitapi.cpp.

IoType

__in PWDFDEVICE_INIT __in WDF_DEVICE_IO_TYPE IoType

Initial value:

{
    DDI_ENTRY()

Definition at line 166 of file fxdeviceinitapi.cpp.

ioTypeConfig

DeviceInit AssignIoType & ioTypeConfig

Definition at line 171 of file fxdeviceinitapi.cpp.

IoTypeConfig

_In_ PWDFDEVICE_INIT _In_ PWDF_IO_TYPE_CONFIG IoTypeConfig

Initial value:

{
    DDI_ENTRY()

Definition at line 191 of file fxdeviceinitapi.cpp.

IsPowerPolicyOwner

__in PWDFDEVICE_INIT __in BOOLEAN IsPowerPolicyOwner

Initial value:

{
    DDI_ENTRY()

Definition at line 835 of file fxdeviceinitapi.cpp.

Key

* Key

Initial value:

{
    DDI_ENTRY()

Definition at line 1426 of file fxdeviceinitapi.cpp.

KeyAttributes

_Must_inspect_result_ __in PWDFDEVICE_INIT __in ULONG __in ACCESS_MASK __in_opt PWDF_OBJECT_ATTRIBUTES KeyAttributes

Definition at line 1424 of file fxdeviceinitapi.cpp.

LastDeviceTextEntry

DeviceInit Pdo LastDeviceTextEntry = &pDeviceText->m_Entry

Definition at line 2537 of file fxdeviceinitapi.cpp.

LocaleId

__in PWDFDEVICE_INIT __in LCID LocaleId

Initial value:

{
    DDI_ENTRY()

Definition at line 2457 of file fxdeviceinitapi.cpp.

m_Description

pDeviceText m_Description

Initial value:

= FxDuplicateUnicodeStringToString(
        pFxDriverGlobals, DeviceDescription)

Definition at line 2508 of file fxdeviceinitapi.cpp.

m_LocaleId

pDeviceText m_LocaleId = LocaleId

Definition at line 2506 of file fxdeviceinitapi.cpp.

m_LocationInformation

pDeviceText m_LocationInformation

Initial value:

= FxDuplicateUnicodeStringToString(
        pFxDriverGlobals, DeviceLocation)

Definition at line 2521 of file fxdeviceinitapi.cpp.

MajorFunction

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR MajorFunction

Definition at line 1100 of file fxdeviceinitapi.cpp.

MinorFunctions

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR __in_opt PUCHAR MinorFunctions

Definition at line 1103 of file fxdeviceinitapi.cpp.

normalizedFileClass

normalizedFileClass = FxFileObjectClassNormalize(fileClass)

Definition at line 429 of file fxdeviceinitapi.cpp.

Referenced by if().

normalizedState

ULONG normalizedState = WdfDevStateNormalize(PnpState)

Definition at line 866 of file fxdeviceinitapi.cpp.

Notification

__in PWDFDEVICE_INIT __in PFN_WDF_DEVICE_SHUTDOWN_NOTIFICATION Notification

Definition at line 2722 of file fxdeviceinitapi.cpp.

NumMinorFunctions

_Must_inspect_result_ __in PWDFDEVICE_INIT __in PFN_WDFDEVICE_WDM_IRP_PREPROCESS __in UCHAR __in_opt PUCHAR __in ULONG NumMinorFunctions

Initial value:

{
    DDI_ENTRY()

Definition at line 1105 of file fxdeviceinitapi.cpp.

OrInValues

__in PWDFDEVICE_INIT __in ULONG __in BOOLEAN OrInValues

Initial value:

{
    DDI_ENTRY()

Definition at line 372 of file fxdeviceinitapi.cpp.

ParentDevice

_Must_inspect_result_ __in WDFDEVICE ParentDevice

Initial value:

{
    DDI_ENTRY()

Definition at line 2037 of file fxdeviceinitapi.cpp.

pCallback

FxPowerPolicyStateCallbackInfo * pCallback

Initial value:

= &DeviceInit->PnpPower.PnpStateCallbacks->m_Methods[
        normalizedState - WdfDevStatePnpObjectCreated]

Definition at line 864 of file fxdeviceinitapi.cpp.

Referenced by CLRRuntimeHost_ExecuteInAppDomain(), Context_CC_ContextCallback(), CorDebug_SetManagedHandler(), CorDebug_SetUnmanagedHandler(), fnCaptureGraphBuilder2_CopyCaptureFile(), fnCaptureGraphBuilder_CopyCaptureFile(), GraphConfig_Reconfigure(), IMAPTransport_InitNew(), Main_DirectDraw_EnumDisplayModes(), Main_DirectDraw_EnumDisplayModes4(), MD_RichEdit_OnSetOleCallback(), MimeMessage_CreateWebPage(), POP3Transport_InitNew(), RSHELL_CStartMenu_CreateInstance(), and SMTPTransport_InitNew().

pDevice

FxDevice* pDevice

Definition at line 2044 of file fxdeviceinitapi.cpp.

pDeviceText

pDeviceText = new(pFxDriverGlobals, PagedPool) FxDeviceText()

Definition at line 2463 of file fxdeviceinitapi.cpp.

Referenced by FindObjectForGivenLocale().

pDriver

FxDriver * pDriver

Definition at line 2689 of file fxdeviceinitapi.cpp.

Referenced by _RpcGetPrinterDriver(), _RpcGetPrinterDriver2(), FxPkgIo::CreateQueue(), EMFDC_WriteNamedEscape(), if(), NamedEscape(), NtGdiExtEscape(), pointer_default(), and YGetPrinterDriver2().

pFxDriverGlobals

pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)

Definition at line 197 of file fxdeviceinitapi.cpp.

Referenced by if(), and switch().

pID

FxString * pID = new(pFxDriverGlobals, WDF_NO_OBJECT_ATTRIBUTES) FxString(pFxDriverGlobals)

Definition at line 2266 of file fxdeviceinitapi.cpp.

Referenced by if().

pInit

return pInit = new(pFxDriverGlobals) WDFDEVICE_INIT(pDevice->GetDriver())

Definition at line 2043 of file fxdeviceinitapi.cpp.

Referenced by WDFDEVICE_INIT::_AllocateControlDeviceInit(), FxDevice::_Create(), CRegPropertyBag::_ReadStream(), CRegFolder_CreateInstance(), CDefaultContextMenu::DoCopyToMoveToFolder(), and CRegFolder::Initialize().

PnpPowerEventCallbacks

__in PWDFDEVICE_INIT __in PWDF_PNPPOWER_EVENT_CALLBACKS PnpPowerEventCallbacks

Initial value:

{
    DDI_ENTRY()

Definition at line 709 of file fxdeviceinitapi.cpp.

PnpState

_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_PNP_STATE PnpState

Definition at line 855 of file fxdeviceinitapi.cpp.

PoolType

_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ _Strict_type_match_ POOL_TYPE PoolType

Definition at line 1917 of file fxdeviceinitapi.cpp.

PowerPageable

DeviceInit PowerPageable = FALSE

Definition at line 267 of file fxdeviceinitapi.cpp.

PowerPolicyEventCallbacks

__in PWDFDEVICE_INIT __in PWDF_POWER_POLICY_EVENT_CALLBACKS PowerPolicyEventCallbacks

Initial value:

{
    DDI_ENTRY()

Definition at line 773 of file fxdeviceinitapi.cpp.

PowerPolicyOwner

DeviceInit PnpPower PowerPolicyOwner = IsPowerPolicyOwner ? WdfTrue : WdfFalse

Definition at line 842 of file fxdeviceinitapi.cpp.

PowerPolicyState

_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_POLICY_STATE PowerPolicyState

Definition at line 1016 of file fxdeviceinitapi.cpp.

PowerState

_Must_inspect_result_ __in PWDFDEVICE_INIT __in WDF_DEVICE_POWER_STATE PowerState

Definition at line 935 of file fxdeviceinitapi.cpp.

PropertyBuffer

_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ ULONG _Out_ PVOID PropertyBuffer

Definition at line 1800 of file fxdeviceinitapi.cpp.

PropertyMemory

* PropertyMemory

Initial value:

{
    DDI_ENTRY()

Definition at line 1590 of file fxdeviceinitapi.cpp.

PropertyMemoryAttributes

_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ _Strict_type_match_ POOL_TYPE _In_opt_ PWDF_OBJECT_ATTRIBUTES PropertyMemoryAttributes

Definition at line 1588 of file fxdeviceinitapi.cpp.

Raw

DeviceInit Pdo Raw = TRUE

Definition at line 2619 of file fxdeviceinitapi.cpp.

ReadWriteIoType

ioTypeConfig ReadWriteIoType = IoType

Definition at line 176 of file fxdeviceinitapi.cpp.

Referenced by FxDevice::GetDeviceStackIoType().

ReleaseHardwareOrderOnFailure

DeviceInit ReleaseHardwareOrderOnFailure

Initial value:

{
    DDI_ENTRY()

Definition at line 1320 of file fxdeviceinitapi.cpp.

RemoveLockOptionFlags

DeviceInit RemoveLockOptionFlags = RemoveLockOptions->Flags

Definition at line 1306 of file fxdeviceinitapi.cpp.

RemoveLockOptions

__in PWDFDEVICE_INIT __in PWDF_REMOVE_LOCK_OPTIONS RemoveLockOptions

Initial value:

{
    DDI_ENTRY()

Definition at line 1254 of file fxdeviceinitapi.cpp.

Referenced by if(), and WDF_REMOVE_LOCK_OPTIONS_INIT().

RequestAttributes

__in PWDFDEVICE_INIT __in PWDF_OBJECT_ATTRIBUTES RequestAttributes

Initial value:

{
    DDI_ENTRY()

Definition at line 576 of file fxdeviceinitapi.cpp.

RequiresSelfIoTarget

DeviceInit RequiresSelfIoTarget = TRUE

Definition at line 1375 of file fxdeviceinitapi.cpp.

ResultLength

_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ ULONG _Out_ PVOID _Out_ PULONG ResultLength

Initial value:

{
    DDI_ENTRY()

Definition at line 1512 of file fxdeviceinitapi.cpp.

return

return

Definition at line 1242 of file fxdeviceinitapi.cpp.

SDDLString

_Must_inspect_result_ __in WDFDRIVER __in CONST UNICODE_STRING* SDDLString

Initial value:

{
    DDI_ENTRY()

Definition at line 617 of file fxdeviceinitapi.cpp.

Set

DeviceInit FileObject Set = TRUE

Definition at line 479 of file fxdeviceinitapi.cpp.

ShutdownNotification

DeviceInit Control ShutdownNotification = Notification

Definition at line 2750 of file fxdeviceinitapi.cpp.

Static

pInit Pdo Static = TRUE

Definition at line 2081 of file fxdeviceinitapi.cpp.

status

status

Initial value:

= FxVerifierCheckIrqlLevel(DeviceInit->DriverGlobals,
                                      PASSIVE_LEVEL)

Definition at line 196 of file fxdeviceinitapi.cpp.

Referenced by if().

STATUS_SUCCESS

return STATUS_SUCCESS

Definition at line 922 of file fxdeviceinitapi.cpp.

Referenced by if().

totalDescriptionSize

totalDescriptionSize = 0

Definition at line 1738 of file fxdeviceinitapi.cpp.

Type

_Must_inspect_result_ _In_ PWDFDEVICE_INIT _In_ PWDF_DEVICE_PROPERTY_DATA _In_ _Strict_type_match_ POOL_TYPE _In_opt_ PWDF_OBJECT_ATTRIBUTES _Out_ WDFMEMORY _Out_ PDEVPROPTYPE Type

Initial value:

{
    DDI_ENTRY()

Definition at line 1804 of file fxdeviceinitapi.cpp.

Types

pCallback Types = CallbackTypes

Definition at line 920 of file fxdeviceinitapi.cpp.

validFlags

ULONG validFlags = WDF_REMOVE_LOCK_OPTION_ACQUIRE_FOR_IO

Definition at line 1260 of file fxdeviceinitapi.cpp.

Referenced by if().