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 WdfPdoRetrieveAddressDescription Methode ruft die Adressbeschreibung ab, die einem angegebenen Framework-Geräteobjekt zugeordnet ist.
Syntax
NTSTATUS WdfPdoRetrieveAddressDescription(
[in] WDFDEVICE Device,
[in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);
Die Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt, das das physische Geräteobjekt des Geräts (PDO) darstellt.
[in, out] AddressDescription
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Adressbeschreibung empfängt. Die Adressbeschreibung muss eine WDF_CHILD_ADDRESS_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 handle Device stellt kein Gerät dar, das dynamisch aufgezählt wurde. |
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) |
Siehe auch
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT