WdfDeviceWdmGetDeviceObject, fonction (wdfdevice.h)
[S’applique à KMDF uniquement]
La méthode WdfDeviceWdmGetDeviceObject retourne l’objet d’appareil WDM (Windows Driver Model) associé à un objet d’appareil d’infrastructure spécifié.
Syntaxe
PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
WDFDEVICE Device
);
Paramètres
Device
Handle pour un objet d’appareil d’infrastructure.
Valeur retournée
WdfDeviceWdmGetDeviceObject retourne un pointeur vers une structure DEVICE_OBJECT .
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Le pointeur retourné par la méthode WdfDeviceWdmGetDeviceObject est valide jusqu’à ce que l’objet d’appareil framework soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet de périphérique d’infrastructure, le pointeur est valide jusqu’à ce que la fonction de rappel soit retournée.
Exemples
L’exemple de code suivant crée un message de suivi qui contient des pointeurs vers les objets d’appareil WDM qui représentent l’AOP et le FDO d’un appareil.
TraceEvents(
TRACE_LEVEL_INFORMATION,
AMCC_TRACE_INIT,
"PDO 0x%p, FDO 0x%p",
WdfDeviceWdmGetPhysicalDevice(device),
WdfDeviceWdmGetDeviceObject(device)
);
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) |