#include "fxsupportpch.hpp"

Include dependency graph for fxdeviceinterfaceapi.cpp:

Functions
_Must_inspect_result_	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS NTAPI WDFEXPORT(WdfDeviceCreateDeviceInterface)(__in PWDF_DRIVER_GLOBALS DriverGlobals

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

	FxPointerNotNull (pFxDriverGlobals, InterfaceClassGUID)

	if (!NT_SUCCESS(status))

	if (ReferenceString !=NULL)

	if (pDevice->IsLegacy())

	if (pDeviceInterface==NULL)

pPkgPnp m_DeviceInterfaceLock	AcquireLock (pFxDriverGlobals)

	if (NT_SUCCESS(status))

pPkgPnp m_DeviceInterfaceLock	ReleaseLock (pFxDriverGlobals)

	if (RefString !=NULL)

	for (ple=pPkgPnp->m_DeviceInterfaceHead.Next;ple !=NULL;ple=ple->Next)

	FxObjectHandleGetPtr (pFxDriverGlobals, String, FX_TYPE_STRING,(PVOID *) &pString)

Variables
_Must_inspect_result_ __in WDFDEVICE	Device

_Must_inspect_result_ __in WDFDEVICE __in CONST GUID *	InterfaceClassGUID

_Must_inspect_result_ __in WDFDEVICE __in CONST GUID __in_opt PCUNICODE_STRING	ReferenceString

SINGLE_LIST_ENTRY **	ppPrev

SINGLE_LIST_ENTRY *	pCur

PFX_DRIVER_GLOBALS	pFxDriverGlobals

FxDeviceInterface *	pDeviceInterface = new(pFxDriverGlobals, PagedPool) FxDeviceInterface()

FxDevice *	pDevice

FxPkgPnp *	pPkgPnp = pDevice->m_PkgPnp

NTSTATUS	status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL)

Done	__pad0__

__in WDFDEVICE __in CONST GUID __in_opt PCUNICODE_STRING	RefString

__in WDFDEVICE __in CONST GUID __in_opt PCUNICODE_STRING __in BOOLEAN	State

PSINGLE_LIST_ENTRY	ple

_Must_inspect_result_ __in WDFDEVICE __in CONST GUID __in_opt PCUNICODE_STRING __in WDFSTRING	String

FxString *	pString

Function Documentation

◆ __drv_maxIRQL()

_Must_inspect_result_ __drv_maxIRQL ( PASSIVE_LEVEL )

◆ AcquireLock()

pPkgPnp m_DeviceInterfaceLock AcquireLock ( pFxDriverGlobals )

Referenced by ClassAddChild(), ClassRemoveChild(), FxObject::IsForceDisposeThread(), FxObject::IsPassiveCallbacks(), and FxObject::IsPassiveDispose().

◆ for()

for ( ple = pPkgPnp->m_DeviceInterfaceHead.Next; ple != NULL; ple = ple->Next )

Definition at line 228 of file fxdeviceinterfaceapi.cpp.

                                                                                  {
        FxDeviceInterface *pDI;
 
        pDI = FxDeviceInterface::_FromEntry(ple);
 
        if (FxIsEqualGuid(&pDI->m_InterfaceClassGUID, InterfaceClassGUID)) {
            if (RefString != NULL) {
                if ((RefString->Length == pDI->m_ReferenceString.Length)
                    &&
                    (RtlCompareMemory(RefString->Buffer,
                                      pDI->m_ReferenceString.Buffer,
                                      RefString->Length) == RefString->Length)) {
                    //
                    // They match, carry on
                    //
                    DO_NOTHING();
                }
                else {
                    //
                    // The ref strings do not match, continue on in the search
                    // of the collection.
                    //
                    continue;
                }
            }
            else if (pDI->m_ReferenceString.Length > 0) {
                //
                // Caller didn't specify a ref string but this interface has
                // one, continue on in the search through the collection.
                //
                continue;
            }
 
            //
            // Set the state and break out of the loop because we found our
            // interface.
            //
            pDI->SetState(State);
            break;
        }
    }

◆ FxObjectHandleGetPtr()

FxObjectHandleGetPtr	(	pFxDriverGlobals	,
		String	,
		FX_TYPE_STRING	,
		(PVOID *) &	pString
	)

◆ FxObjectHandleGetPtrAndGlobals()

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

◆ FxPointerNotNull()

FxPointerNotNull	(	pFxDriverGlobals	,
		InterfaceClassGUID
	)

◆ if() [1/6]

if ( ! NT_SUCCESSstatus )

Definition at line 87 of file fxdeviceinterfaceapi.cpp.

                             {
        return status;
    }

◆ if() [2/6]

if ( NT_SUCCESS(status) )

Definition at line 141 of file fxdeviceinterfaceapi.cpp.

                            {
        //
        // Insert into the end of the list
        //
        ppPrev = &pPkgPnp->m_DeviceInterfaceHead.Next;
        pCur = pPkgPnp->m_DeviceInterfaceHead.Next;
        while (pCur != NULL) {
            ppPrev = &pCur->Next;
            pCur = pCur->Next;
        }
 
        *ppPrev = &pDeviceInterface->m_Entry;
    }

◆ if() [3/6]

if ( pDevice-> IsLegacy() )

Definition at line 98 of file fxdeviceinterfaceapi.cpp.

                             {
        status = STATUS_INVALID_DEVICE_REQUEST;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGERROR,
            "WDFDEVICE %p is not a PNP device, device interface creation not "
            "allowed %!STATUS!", Device, status);
 
        return status;
    }

◆ if() [4/6]

if ( pDeviceInterface = = NULL )

Definition at line 111 of file fxdeviceinterfaceapi.cpp.

                                  {
        status = STATUS_INSUFFICIENT_RESOURCES;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGERROR,
            "WDFDEVICE %p DeviceInterface object creation failed, %!STATUS!",
            Device, status);
 
        return status;
    }

◆ if() [5/6]

if ( ReferenceString ! = NULL )

Definition at line 91 of file fxdeviceinterfaceapi.cpp.

                                 {
        status = FxValidateUnicodeString(pFxDriverGlobals, ReferenceString);
        if (!NT_SUCCESS(status)) {
            return status;
        }
    }

◆ if() [6/6]

if ( RefString ! = NULL )

Definition at line 204 of file fxdeviceinterfaceapi.cpp.

                           {
        status = FxValidateUnicodeString(pFxDriverGlobals, RefString);
        if (!NT_SUCCESS(status)) {
            FxVerifierDbgBreakPoint(pFxDriverGlobals);
            return;
        }
    }