WdfWdmDeviceGetWdfDeviceHandle, fonction (wdfdevice.h)

  • Article

[S’applique à KMDF uniquement]

La méthode WdfWdmDeviceGetWdfDeviceHandle retourne un handle à l’objet d’appareil framework associé à un objet d’appareil WDM spécifié.

Syntaxe

WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
  [in] PDEVICE_OBJECT DeviceObject
);

Paramètres

[in] DeviceObject

Pointeur vers une structure de DEVICE_OBJECT WDM créée par le pilote appelant.

Valeur retournée

Si l’objet d’appareil WDM spécifié est valide, WdfWdmDeviceGetWdfDeviceHandle retourne un handle à l’objet d’appareil d’infrastructure associé. Sinon, la méthode retourne NULL.

Remarques

La structure de DEVICE_OBJECT WDM que le pilote spécifie pour le paramètre DeviceObject doit représenter un objet de périphérique créé par le pilote appelant. Par exemple, la structure ne peut représenter aucun des objets de périphérique WDM spécifiés par le pilote lors d’un appel précédent à WdfDeviceMiniportCreate.

Exemples

L’exemple de code suivant obtient un handle pour l’objet d’appareil framework associé à un objet d’appareil WDM créé par le pilote appelant.

WDFDEVICE  device;

device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);

Configuration requise

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

Voir aussi

WdfDeviceMiniportCreate