WdfWdmDeviceGetWdfDeviceHandle, fonction (wdfdevice.h)
[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) |