WdfPdoRetrieveAddressDescription-Funktion (wdfpdo.h)

  • Artikel

[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
STATUS_INVALID_PARAMETER
 Das Gerätehandle stellt keine PDO dar.
STATUS_INVALID_DEVICE_REQUEST
 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

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription