Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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
);
Die Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt, das das physische Geräteobjekt des Geräts (PDO) darstellt.
[in, out] IdentificationDescription
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Identifikationsbeschreibung erhält. 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 Device Handle stellt keine PDO dar. |
|
Das Device Handle stellt kein Gerät dar, das dynamisch aufgezählt wurde, oder wenn die WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER-Struktur nicht die richtige Puffergröße enthält. |
Die Methode gibt möglicherweise auch andere NTSTATUS-Wertezurück.
Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdfpdo.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |