WdfFdoInitWdmGetPhysicalDevice, fonction (wdffdo.h)

  • Article

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

Paramètres

[in] DeviceInit

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

Valeur retournée

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

Remarques

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.

Exemples

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

Configuration requise

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)