#include "coreprivshared.hpp"

Include dependency graph for fxdeviceinitapi.cpp:

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 hardware.c.

{
    SendKey();
    Wake(LogicalDevice->CSN);
}

◆ _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:

{

Classes

Typedefs

Functions

Variables

Typedef Documentation

◆ PWDF_PDO_EVENT_CALLBACKS_V1_9

◆ PWDF_PNPPOWER_EVENT_CALLBACKS_V1_9

◆ PWDF_POWER_POLICY_EVENT_CALLBACKS_V1_5

◆ WDF_PDO_EVENT_CALLBACKS_V1_9

◆ WDF_PNPPOWER_EVENT_CALLBACKS_V1_9

◆ WDF_POWER_POLICY_EVENT_CALLBACKS_V1_5

Function Documentation

◆ __drv_maxIRQL() [1/2]

◆ __drv_maxIRQL() [2/2]

◆ __drv_strictTypeMatch()

◆ __drv_when()

◆ __out_bcount_full_opt()

◆ _IRQL_requires_max_() [1/2]

◆ _IRQL_requires_max_() [2/2]

◆ Assign()

◆ AssignIoType()

◆ AssignName()

◆ DeviceInit() [1/6]

◆ DeviceInit() [2/6]

◆ DeviceInit() [3/6]

◆ DeviceInit() [4/6]

◆ DeviceInit() [5/6]

◆ DeviceInit() [6/6]

◆ FxObjectHandleGetPtrAndGlobals() [1/2]

◆ FxObjectHandleGetPtrAndGlobals() [2/2]

◆ FxPointerNotNull() [1/25]

◆ FxPointerNotNull() [2/25]

◆ FxPointerNotNull() [3/25]

◆ FxPointerNotNull() [4/25]

◆ FxPointerNotNull() [5/25]

◆ FxPointerNotNull() [6/25]

◆ FxPointerNotNull() [7/25]

◆ FxPointerNotNull() [8/25]

◆ FxPointerNotNull() [9/25]

◆ FxPointerNotNull() [10/25]

◆ FxPointerNotNull() [11/25]

◆ FxPointerNotNull() [12/25]

◆ FxPointerNotNull() [13/25]

◆ FxPointerNotNull() [14/25]

◆ FxPointerNotNull() [15/25]

◆ FxPointerNotNull() [16/25]

◆ FxPointerNotNull() [17/25]

◆ FxPointerNotNull() [18/25]

◆ FxPointerNotNull() [19/25]

◆ FxPointerNotNull() [20/25]

◆ FxPointerNotNull() [21/25]

◆ FxPointerNotNull() [22/25]

◆ FxPointerNotNull() [23/25]

◆ FxPointerNotNull() [24/25]

◆ FxPointerNotNull() [25/25]

◆ FxVerifierCheckNxPoolType()

◆ if() [1/45]

◆ if() [2/45]

◆ if() [3/45]

◆ if() [4/45]

◆ if() [5/45]

◆ if() [6/45]

◆ if() [7/45]

◆ if() [8/45]

◆ if() [9/45]

◆ if() [10/45]

◆ if() [11/45]

◆ if() [12/45]

◆ if() [13/45]

◆ if() [14/45]

◆ if() [15/45]

◆ if() [16/45]

◆ if() [17/45]

◆ if() [18/45]

◆ if() [19/45]

◆ if() [20/45]

◆ if() [21/45]

◆ if() [22/45]

◆ if() [23/45]

◆ if() [24/45]

◆ pad0

◆ pad1