WdfPdoUpdateAddressDescription-Funktion (wdfpdo.h)
[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 |
|---|---|
|
Das Gerätehandle stellt keine PDO dar. |
|
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) |