WdfFdoInitWdmGetPhysicalDevice, fonction (wdffdo.h)

[S’applique à KMDF uniquement]

La méthode WdfFdoInitWdmGetPhysicalDevice récupère l’objet de périphérique physique WDM d’un appareil.

Syntaxe

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT que le pilote a obtenue à partir de sa fonction de rappel EvtDriverDeviceAdd .

Si l’opération réussit, la méthode retourne un pointeur vers une structure DEVICE_OBJECT . Sinon, la méthode retourne NULL.

Le pilote doit appeler WdfFdoInitWdmGetPhysicalDevice avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.

Pour plus d’informations sur la méthode WdfFdoInitWdmGetPhysicalDevice , consultez Création d’objets d’appareil dans un pilote de fonction.

L’exemple de code suivant obtient un pointeur vers une structure DEVICE_OBJECT qui représente l’AOP WDM d’un appareil.

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdffdo.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)