WdfPdoRetrieveAddressDescription-Funktion (wdfpdo.h)

Artikel
03/22/2025

[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
STATUS_INVALID_PARAMETER	Das Device Handle stellt keine PDO dar.
STATUS_INVALID_DEVICE_REQUEST	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

WdfChildListRetrieveAddressDescription

WdfPdoRetrieveIdentificationDescription-

Freigeben über