WdfPdoUpdateAddressDescription-Funktion (wdfpdo.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfPdoUpdateAddressDescription-Methode aktualisiert die Adressbeschreibung , die einem angegebenen Framework-Geräteobjekt zugeordnet ist.

Syntax

NTSTATUS WdfPdoUpdateAddressDescription(
  [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) eines Geräts darstellt.

[in, out] AddressDescription

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der eine Adressbeschreibung enthält. 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, oder wenn der Size-Member der angegebenen WDF_CHILD_ADDRESS_DESCRIPTION_HEADER Struktur nicht mit der Größe der vorhandenen Adressbeschreibung des Geräts übereinstimmt.
 

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

WdfPdoRetrieveAddressDescription