fxdevicefdoapi.cpp File Reference

#include "fxcorepch.hpp"

Include dependency graph for fxdevicefdoapi.cpp:

Go to the source code of this file.

Functions
_Must_inspect_result_	__drv_maxIRQL (DISPATCH_LEVEL) NTSTATUS NTAPI WDFEXPORT(WdfFdoAddStaticChild)(__in PWDF_DRIVER_GLOBALS DriverGlobals
	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), Fdo, FX_TYPE_DEVICE,(PVOID *)&pFdo)
	if (pFdo->IsLegacy()||pFdo->IsFdo()==FALSE)
	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), Child, FX_TYPE_DEVICE,(PVOID *)&pPdo)
	if (pPdo->IsLegacy()||pPdo->IsPdo()==FALSE)
	if (NT_SUCCESS(status))
	FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), Fdo, FX_TYPE_DEVICE,(PVOID *)&pDevice, &pFxDriverGlobals)
	if (pDevice->IsLegacy()||(pDevice->IsFdo()==FALSE))
	if (Flags==0||(Flags &~WdfRetrieveAllChildren) !=0)
_Must_inspect_result_	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS NTAPI WDFEXPORT(WdfFdoQueryForInterface)(__in PWDF_DRIVER_GLOBALS DriverGlobals
	FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), Fdo, FX_TYPE_DEVICE_BASE,(PVOID *)&pDeviceBase, &pFxDriverGlobals)
	FxPointerNotNull (pFxDriverGlobals, InterfaceType)
	FxPointerNotNull (pFxDriverGlobals, Interface)
	if (!NT_SUCCESS(status))
	if (NT_SUCCESS(pDeviceBase->QueryInterface(&params)))
return pDeviceBase	QueryForInterface (InterfaceType, Interface, Size, Version, InterfaceSpecificData)
	if (pPkgFdo->m_DefaultDeviceList !=NULL)

Variables
_Must_inspect_result_ __in WDFDEVICE	Fdo
_Must_inspect_result_ __in WDFDEVICE __in WDFDEVICE	Child
FxDevice *	pFdo
FxDevice *	pPdo
FxPkgFdo *	pPkgFdo = pFdo->GetFdoPkg()
NTSTATUS	status = pPkgFdo->m_StaticDeviceList->Add(&description.Header, NULL, NULL)
description Header	IdentificationDescriptionSize = sizeof(description)
description	Pdo = pPdo
WDF_CHILD_LIST_ITERATOR	iterator
FxDevice *	pDevice = NULL
_Must_inspect_result_ __in WDFDEVICE __in WDFDEVICE	PreviousChild
_Must_inspect_result_ __in WDFDEVICE __in WDFDEVICE __in ULONG	Flags
WDFDEVICE	next = pPkgFdo->m_StaticDeviceList->GetNextStaticDevice(PreviousChild, Flags)
_Must_inspect_result_ __in WDFDEVICE __in LPCGUID	InterfaceType
_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE	Interface
_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE __in USHORT	Size
_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE __in USHORT __in USHORT	Version
_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE __in USHORT __in USHORT __in_opt PVOID	InterfaceSpecificData
FxDeviceBase *	pDeviceBase
FxQueryInterfaceParams	params = { (PVOID*) &pDevice, FX_TYPE_DEVICE, 0 }
	else
return	NULL

Function Documentation

__drv_maxIRQL() [1/2]

_Must_inspect_result_ __drv_maxIRQL

(

DISPATCH_LEVEL

)

__drv_maxIRQL() [2/2]

_Must_inspect_result_ __drv_maxIRQL

(

PASSIVE_LEVEL

)

FxObjectHandleGetPtr() [1/2]

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		Child	,
		FX_TYPE_DEVICE	,
		(PVOID *)&	pPdo
	)

FxObjectHandleGetPtr() [2/2]

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		Fdo	,
		FX_TYPE_DEVICE	,
		(PVOID *)&	pFdo
	)

Referenced by __out_bcount(), FxIoTargetRemote::_Create(), FxUsbPipe::_FormatTransfer(), FxDeviceBase::_SearchForDevice(), FxObject::Commit(), FxPkgIo::CreateQueue(), FxUsbDevice::GetInterfaceNumberFromInterface(), FxInterrupt::InitializeWorker(), PerfEvtIoStopStart(), PerfEvtIoStopStop(), PerformanceAnalysisIOProcess(), and FxRequestBuffer::ValidateMemoryDescriptor().

FxObjectHandleGetPtrAndGlobals() [1/2]

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

FxObjectHandleGetPtrAndGlobals() [2/2]

FxObjectHandleGetPtrAndGlobals	(	GetFxDriverGlobals(DriverGlobals)	,
		Fdo	,
		FX_TYPE_DEVICE_BASE	,
		(PVOID *)&	pDeviceBase,
		&	pFxDriverGlobals
	)

FxPointerNotNull() [1/2]

FxPointerNotNull	(	pFxDriverGlobals	,
		Interface
	)

FxPointerNotNull() [2/2]

FxPointerNotNull	(	pFxDriverGlobals	,
		InterfaceType
	)

if() [1/8]

if

(

!

NT_SUCCESSstatus

)

Definition at line 378 of file fxdevicefdoapi.cpp.

                             {
        return status;
    }

if() [2/8]

if

(

Flags

= = 0 || (Flags & ~WdfRetrieveAllChildren) != 0

)

Definition at line 234 of file fxdevicefdoapi.cpp.

                                                              {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Invalid Flags 0x%x", Flags);
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return NULL;
    }

if() [3/8]

if

(

NT_SUCCESS(pDeviceBase->QueryInterface(&params))

)

Definition at line 385 of file fxdevicefdoapi.cpp.

                                                          {
        //
        // Verify type
        //
        if (pDevice->IsLegacy() || (pDevice->IsFdo() == FALSE)) {
            status = STATUS_INVALID_PARAMETER;
 
            DoTraceLevelMessage(
                pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "WDFDEVICE 0x%p Device is either legacy or is not a Fdo %!STATUS!",
                Fdo, status);
 
            return status;
        }
    }

if() [4/8]

if

(

NT_SUCCESS(status)

)

Definition at line 116 of file fxdevicefdoapi.cpp.

                            {
        pFdo->SetDeviceTelemetryInfoFlags(DeviceInfoHasStaticChildren);
    }

if() [5/8]

if

(

pDevice->

IsLegacy)||(pDevice->IsFdo()==FALSE

)

Definition at line 162 of file fxdevicefdoapi.cpp.

                                                            {
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "Invalid WDFDEVICE %p is not an FDO", Fdo);
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [6/8]

if

(

pFdo->

IsLegacy)||pFdo->IsFdo( = = FALSE

)

Definition at line 78 of file fxdevicefdoapi.cpp.

                                                    {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(
            pFdo->GetDriverGlobals(), TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "WDFDEVICE 0x%p is either legacy or is not a Fdo, %!STATUS!",
            Fdo, status);
 
        return status;
    }

if() [7/8]

if

(

pPdo->

IsLegacy)||pPdo->IsPdo( = = FALSE

)

Definition at line 94 of file fxdevicefdoapi.cpp.

                                                    {
        status = STATUS_INVALID_PARAMETER;
 
        DoTraceLevelMessage(
            pFdo->GetDriverGlobals(), TRACE_LEVEL_ERROR, TRACINGDEVICE,
            "WDFDEVICE Child 0x%p is either legacy or is not a PDO, %!STATUS!",
            Child, status);
 
        return status;
    }

if() [8/8]

if

(

pPkgFdo->m_DefaultDeviceList !

= NULL

)

Definition at line 458 of file fxdevicefdoapi.cpp.

                                              {
        return (WDFCHILDLIST) pPkgFdo->m_DefaultDeviceList->GetObjectHandle();
    }

QueryForInterface()

return pDeviceBase QueryForInterface	(	InterfaceType	,
		Interface	,
		Size	,
		Version	,
		InterfaceSpecificData
	)

Variable Documentation

Child

_Must_inspect_result_ __in WDFDEVICE __in WDFDEVICE Child

Initial value:

{
    FxStaticChildDescription description

Definition at line 46 of file fxdevicefdoapi.cpp.

else

else

Initial value:

{
        
        
        
        DO_NOTHING()

Definition at line 400 of file fxdevicefdoapi.cpp.

Fdo

__in WDFDEVICE Fdo

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 44 of file fxdevicefdoapi.cpp.

Flags

_Must_inspect_result_ __in WDFDEVICE __in WDFDEVICE __in ULONG Flags

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 193 of file fxdevicefdoapi.cpp.

IdentificationDescriptionSize

description Header IdentificationDescriptionSize = sizeof(description)

Definition at line 111 of file fxdevicefdoapi.cpp.

Referenced by FxChildList::_ComputeTotalDescriptionSize(), FxDeviceDescriptionEntry::FxDeviceDescriptionEntry(), WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(), and WDF_CHILD_LIST_CONFIG_INIT().

Interface

_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE Interface

Definition at line 327 of file fxdevicefdoapi.cpp.

InterfaceSpecificData

_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE __in USHORT __in USHORT __in_opt PVOID InterfaceSpecificData

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 333 of file fxdevicefdoapi.cpp.

InterfaceType

_Must_inspect_result_ __in WDFDEVICE __in LPCGUID InterfaceType

Definition at line 325 of file fxdevicefdoapi.cpp.

iterator

pPkgFdo m_StaticDeviceList EndIteration & iterator

Definition at line 149 of file fxdevicefdoapi.cpp.

next

return next = pPkgFdo->m_StaticDeviceList->GetNextStaticDevice(PreviousChild, Flags)

Definition at line 223 of file fxdevicefdoapi.cpp.

NULL

return NULL

Definition at line 466 of file fxdevicefdoapi.cpp.

Referenced by if().

params

FxQueryInterfaceParams params = { (PVOID*) &pDevice, FX_TYPE_DEVICE, 0 }

Definition at line 363 of file fxdevicefdoapi.cpp.

pDevice

FxDevice* pDevice = NULL

Definition at line 150 of file fxdevicefdoapi.cpp.

Referenced by if().

pDeviceBase

FxDeviceBase * pDeviceBase

Definition at line 361 of file fxdevicefdoapi.cpp.

Referenced by FxMemoryBufferFromPool::_Create(), and FxDeviceBase::_SearchForDevice().

Pdo

description Pdo = pPdo

Definition at line 112 of file fxdevicefdoapi.cpp.

pFdo

FxDevice* pFdo

Definition at line 65 of file fxdevicefdoapi.cpp.

Referenced by AddDeviceInternal(), if(), and SerialAddDeviceInternal().

pPdo

MdDeviceObject pPdo

Definition at line 66 of file fxdevicefdoapi.cpp.

Referenced by FxChildList::Add(), FxDevice::CreateSymbolicLink(), FxChildList::DrainFreeListHead(), and FxPkgPdo::Initialize().

pPkgFdo

FxPkgFdo * pPkgFdo = pFdo->GetFdoPkg()

Definition at line 67 of file fxdevicefdoapi.cpp.

Referenced by FxPkgFdo::_PnpFilteredStartDeviceCompletionRoutine(), and if().

PreviousChild

_Must_inspect_result_ __in WDFDEVICE __in WDFDEVICE PreviousChild

Definition at line 191 of file fxdevicefdoapi.cpp.

Size

_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE __in USHORT Size

Definition at line 329 of file fxdevicefdoapi.cpp.

status

status = pPkgFdo->m_StaticDeviceList->Add(&description.Header, NULL, NULL)

Definition at line 68 of file fxdevicefdoapi.cpp.

Referenced by if().

Version

_Must_inspect_result_ __in WDFDEVICE __in LPCGUID __out PINTERFACE __in USHORT __in USHORT Version

Definition at line 331 of file fxdevicefdoapi.cpp.