Condividi tramite


Funzione WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

[Si applica solo a KMDF]

Il metodo WdfFdoInitWdmGetPhysicalDevice recupera l'oggetto dispositivo fisico WDM di un dispositivo (PDO).

Sintassi

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT ottenuta dal driver dalla funzione EvtDriverDeviceAdd callback.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce un puntatore a una struttura DEVICE_OBJECT . In caso contrario, il metodo restituisce NULL.

Commenti

Il driver deve chiamare WdfFdoInitWdmGetPhysicalDevice prima di chiamare WdfDeviceCreate. Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo Framework.

Per altre informazioni sul metodo WdfFdoInitWdmGetPhysicalDevice , vedere Creazione di oggetti dispositivo in un driver di funzione.

Esempio

Nell'esempio di codice seguente viene ottenuto un puntatore a una struttura DEVICE_OBJECT che rappresenta il PDO WDM di un dispositivo.

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdffdo.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)