WdfDeviceAssignProperty-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfDeviceAssignProperty Methode ändert die aktuelle Einstellung einer Geräteeigenschaft.

Syntax

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] DeviceProperty

Ein Zeiger auf eine WDF_DEVICE_PROPERTY_DATA Struktur, die die zu ändernde Geräteeigenschaft identifiziert.

[in] Type

Eine DEVPROPTYPE-Variable vom Typ "-typed", die den Typ der in Datagespeicherten Daten angibt.

[in] Size

Die Größe des Puffers in Byte, auf den Dataverweist.

[in, optional] Data

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Geräteeigenschaftendaten enthält. Legen Sie diesen Parameter auf NULL- fest, um die angegebene Eigenschaft zu löschen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt WdfDeviceAssignProperty STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Einer der Parameter ist falsch.

Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Sie können WdfDeviceAssignProperty- verwenden, um die Einstellung jeder Eigenschaft zu ändern, die über das einheitliche Eigenschaftenmodell verfügbar gemacht wird.

Informationen zu verwandten Methoden finden Sie unter Zugreifen auf das Unified Device Property Model.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.13
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	APC_LEVEL

Siehe auch

WdfDeviceAssignInterfaceProperty

Freigeben über