Funzione WdfDeviceWdmGetPhysicalDevice (wdfdevice.h)

[Si applica solo a KMDF]

Il metodo WdfDeviceWdmGetPhysicalDevice recupera il PDO WDM del dispositivo fisico dallo stack di dispositivi.

Sintassi

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

Valore restituito

WdfDeviceWdmGetPhysicalDevice restituisce un puntatore a una struttura DEVICE_OBJECT .

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

WdfDeviceWdmGetPhysicalDevice restituisce NULL se il chiamante fornisce un oggetto dispositivo di controllo.

Commenti

Il puntatore restituito dal metodo WdfDeviceWdmGetPhysicalDevice è valido fino a quando non viene eliminato l'oggetto dispositivo framework. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto dispositivo framework, il puntatore è valido fino a quando non viene restituita la funzione di callback.

Esempio

Per un esempio di codice che usa WdfDeviceWdmGetPhysicalDevice, vedere WdfDeviceWdmGetAttachedDevice.

Requisiti