WdfPdoRetrieveAddressDescription-Funktion (wdfpdo.h)
[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
);
Parameter
[in] Device
Ein Handle für ein Frameworkgeräteobjekt, das das physische Geräteobjekt (PDO) des Geräts 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 Gerätehandle stellt keine PDO dar. |
|
Das Gerätehandle stellt kein Gerät dar, das dynamisch aufgezählt wurde. |
Die -Methode gibt möglicherweise auch andere NTSTATUS-Werte zurück.
Eine Systemfehlerüberprü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 Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Weitere Informationen
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT