Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique uniquement à KMDF]
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 de retour
Si l’objet d’appareil WDM spécifié est valide, WdfWdmDeviceGetWdfDeviceHandle retourne un handle à l’objet d’appareil framework associé. Sinon, la méthode retourne NULL.
Remarques
La structure DEVICE_OBJECT WDM spécifiée par le pilote pour le paramètre DeviceObject doit représenter un objet d’appareil que le pilote appelant a créé. Par exemple, la structure ne peut représenter aucun des objets de périphérique WDM spécifiés dans 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 que le pilote appelant a créé.
WDFDEVICE device;
device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| En-tête | wdfdevice.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <=DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |