#include "../../fxtargetsshared.hpp"

Include dependency graph for fxiotargetapikm.cpp:

Functions
	__drv_maxIRQL (DISPATCH_LEVEL) PDEVICE_OBJECT NTAPI WDFEXPORT(WdfIoTargetWdmGetTargetDeviceObject)(__in PWDF_DRIVER_GLOBALS DriverGlobals

	FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), IoTarget, FX_TYPE_IO_TARGET,(PVOID *) &pTarget, &pFxDriverGlobals)

	DoTraceLevelMessage (pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGIOTARGET, "enter WDFIOTARGET 0x%p", IoTarget)

	DoTraceLevelMessage (pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGIOTARGET, "exit WDFIOTARGET 0x%p, WDM DevObj 0x%p", IoTarget, pDevice)

	DoTraceLevelMessage (pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGIOTARGET, "exit WDFIOTARGET 0x%p, WDM PDO 0x%p", IoTarget, pPdo)

	DoTraceLevelMessage (pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGIOTARGET, "exit WDFIOTARGET 0x%p, WDM FileObj 0x%p", IoTarget, pFile)

	__drv_maxIRQL (PASSIVE_LEVEL) _Must_inspect_result_ NTSTATUS NTAPI WDFEXPORT(WdfIoTargetQueryForInterface)(__in PWDF_DRIVER_GLOBALS DriverGlobals

	FxPointerNotNull (pFxDriverGlobals, InterfaceType)

	FxPointerNotNull (pFxDriverGlobals, Interface)

	if (!NT_SUCCESS(status))

	ASSERT (pTopOfStack !=NULL)

	ObDereferenceObject (pTopOfStack)

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in ULONG	__drv_when (BufferLength !=0, __out_bcount_part_opt(BufferLength, *ResultLength)) __drv_when(BufferLength

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in ULONG __out_opt PVOID	__deref_out_range (<=, BufferLength) PULONG ResultLength)

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in	__drv_strictTypeMatch (1) POOL_TYPE PoolType

	FxPointerNotNull (pFxDriverGlobals, PropertyMemory)

	FxVerifierCheckNxPoolType (pFxDriverGlobals, PoolType, pFxDriverGlobals->Tag)

	if (pPdo==NULL)

	DoTraceLevelMessage (pFxDriverGlobals, TRACE_LEVEL_VERBOSE, TRACINGIOTARGET, "exit WDFIOTARGET 0x%p, Property %d, %!STATUS!", IoTarget, DeviceProperty, status)

Variables
__in WDFIOTARGET	IoTarget

FxIoTarget *	pTarget

PDEVICE_OBJECT	pDevice = pTarget->GetTargetDevice()

PDEVICE_OBJECT	pPdo = pTarget->GetTargetPDO()

MdFileObject	pFile = pTarget->GetTargetFileObject()

__in WDFIOTARGET __in LPCGUID	InterfaceType

__in WDFIOTARGET __in LPCGUID __out PINTERFACE	Interface

__in WDFIOTARGET __in LPCGUID __out PINTERFACE __in USHORT	Size

__in WDFIOTARGET __in LPCGUID __out PINTERFACE __in USHORT __in USHORT	Version

__in WDFIOTARGET __in LPCGUID __out PINTERFACE __in USHORT __in USHORT __in_opt PVOID	InterfaceSpecificData

PFX_DRIVER_GLOBALS	pFxDriverGlobals

PDEVICE_OBJECT	pTopOfStack = IoGetAttachedDeviceReference(pTarget->GetTargetDevice())

NTSTATUS	status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL)

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY	DeviceProperty

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in ULONG	BufferLength

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in ULONG __out_opt PVOID	PropertyBuffer

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in __in_opt PWDF_OBJECT_ATTRIBUTES	PropertyMemoryAttributes

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in __in_opt PWDF_OBJECT_ATTRIBUTES __out WDFMEMORY *	PropertyMemory

Function Documentation

◆ __deref_out_range()

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in ULONG __out_opt PVOID __deref_out_range	(	<=	,
		BufferLength
	)

Definition at line 262 of file fxiotargetapikm.cpp.

{
    DDI_ENTRY();
 
    PFX_DRIVER_GLOBALS pGlobals;
    NTSTATUS status;
    FxIoTarget* pTarget;
    MdDeviceObject pPdo;
 
    FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals),
                                   IoTarget,
                                   FX_TYPE_IO_TARGET,
                                   (PVOID*) &pTarget,
                                   &pGlobals);
 
    FxPointerNotNull(pGlobals, ResultLength);
    if (BufferLength > 0) {
        FxPointerNotNull(pGlobals, PropertyBuffer);
    }
 
    status = FxVerifierCheckIrqlLevel(pGlobals, PASSIVE_LEVEL);
    if (!NT_SUCCESS(status)) {
        return status;
    }
 
    pPdo = pTarget->GetTargetPDO();
 
    if (pPdo == NULL) {
        status = STATUS_INVALID_DEVICE_REQUEST;
 
        DoTraceLevelMessage(pGlobals, TRACE_LEVEL_ERROR, TRACINGIOTARGET,
                            "WDFIOTARGET 0x%p has no PDO (not opened yet?), %!STATUS!",
                            IoTarget, status);
 
        return status;
    }
 
    status = FxDevice::_GetDeviceProperty(pPdo,
                                          DeviceProperty,
                                          BufferLength,
                                          PropertyBuffer,
                                          ResultLength);
 
    DoTraceLevelMessage(pGlobals, TRACE_LEVEL_VERBOSE, TRACINGIOTARGET,
                        "exit WDFIOTARGET 0x%p, Property %d, %!STATUS!",
                        IoTarget, DeviceProperty, status);
 
 
 
    return status;
}

◆ __drv_maxIRQL() [1/2]

__drv_maxIRQL ( DISPATCH_LEVEL )

◆ __drv_maxIRQL() [2/2]

__drv_maxIRQL ( PASSIVE_LEVEL )

◆ __drv_strictTypeMatch()

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in __drv_strictTypeMatch ( 1 )

◆ __drv_when()

_Must_inspect_result_ __in WDFIOTARGET __in DEVICE_REGISTRY_PROPERTY __in ULONG __drv_when	(	BufferLength !	= `0`,
		__out_bcount_part_opt(BufferLength, *ResultLength)
	)

◆ ASSERT()

ASSERT ( pTopOfStack ! = NULL )

◆ DoTraceLevelMessage() [1/5]

DoTraceLevelMessage	(	pFxDriverGlobals	,
		TRACE_LEVEL_VERBOSE	,
		TRACINGIOTARGET	,
		"enter WDFIOTARGET 0x%p"	,
		IoTarget
	)

Referenced by __deref_out_range(), and if().

◆ DoTraceLevelMessage() [2/5]

DoTraceLevelMessage	(	pFxDriverGlobals	,
		TRACE_LEVEL_VERBOSE	,
		TRACINGIOTARGET	,
		"exit WDFIOTARGET 0x%	p,
		Property %	d,
		%!STATUS!"	,
		IoTarget	,
		DeviceProperty	,
		status
	)

◆ DoTraceLevelMessage() [3/5]

DoTraceLevelMessage	(	pFxDriverGlobals	,
		TRACE_LEVEL_VERBOSE	,
		TRACINGIOTARGET	,
		"exit WDFIOTARGET 0x%	p,
		WDM DevObj 0x%p"	,
		IoTarget	,
		pDevice
	)

◆ DoTraceLevelMessage() [4/5]

DoTraceLevelMessage	(	pFxDriverGlobals	,
		TRACE_LEVEL_VERBOSE	,
		TRACINGIOTARGET	,
		"exit WDFIOTARGET 0x%	p,
		WDM FileObj 0x%p"	,
		IoTarget	,
		pFile
	)

◆ DoTraceLevelMessage() [5/5]

DoTraceLevelMessage	(	pFxDriverGlobals	,
		TRACE_LEVEL_VERBOSE	,
		TRACINGIOTARGET	,
		"exit WDFIOTARGET 0x%	p,
		WDM PDO 0x%p"	,
		IoTarget	,
		pPdo
	)

◆ FxObjectHandleGetPtrAndGlobals()

FxObjectHandleGetPtrAndGlobals	(	GetFxDriverGlobals(DriverGlobals)	,
		IoTarget	,
		FX_TYPE_IO_TARGET	,
		(PVOID *) &	pTarget,
		&	pFxDriverGlobals
	)

Referenced by __deref_out_range().

◆ FxPointerNotNull() [1/3]

FxPointerNotNull	(	pFxDriverGlobals	,
		Interface
	)

◆ FxPointerNotNull() [2/3]

FxPointerNotNull	(	pFxDriverGlobals	,
		InterfaceType
	)

◆ FxPointerNotNull() [3/3]

FxPointerNotNull	(	pFxDriverGlobals	,
		PropertyMemory
	)

◆ FxVerifierCheckNxPoolType()

FxVerifierCheckNxPoolType	(	pFxDriverGlobals	,
		PoolType	,
		pFxDriverGlobals->	Tag
	)

◆ if() [1/2]

if ( ! NT_SUCCESSstatus )

Definition at line 227 of file fxiotargetapikm.cpp.

                             {
        return status;
    }

◆ if() [2/2]

if ( pPdo = = NULL )

Definition at line 409 of file fxiotargetapikm.cpp.

                      {
        status = STATUS_INVALID_DEVICE_REQUEST;
 
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGIOTARGET,
                            "WDFIOTARGET %p has no PDO (not opened yet?), %!STATUS!",
                            IoTarget, status);
 
        return status;
    }