WdfPdoRetrieveIdentificationDescription-Funktion (wdfpdo.h)
[Gilt nur für KMDF]
Die WdfPdoRetrieveIdentificationDescription-Methode ruft die Identifikationsbeschreibung ab, die einem angegebenen Framework-Geräteobjekt zugeordnet ist.
Syntax
NTSTATUS WdfPdoRetrieveIdentificationDescription(
[in] WDFDEVICE Device,
[in, out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
Parameter
[in] Device
Ein Handle für ein Frameworkgeräteobjekt, das das physische Geräteobjekt (PDO) des Geräts darstellt.
[in, out] IdentificationDescription
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Identifikationsbeschreibung empfängt. Die Identifikationsbeschreibung muss eine WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur enthalten.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Das Gerätehandle stellt kein PDO dar. |
|
Das Gerätehandle stellt kein Gerät dar, das dynamisch aufgelistet wurde, oder wenn die WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Struktur nicht die richtige Puffergröße enthält. |
Die Methode kann auch andere NTSTATUS-Werte zurückgeben.
Eine Systemfehlerprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfpdo.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |