Funzione WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

Articolo
03/05/2024

[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)

Condividi tramite