WdfDeviceAssignProperty-Funktion (wdfdevice.h)

  • Artikel

[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 für ein Framework-Geräteobjekt.

[in] DeviceProperty

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

[in] Type

Eine VARIABLE vom Typ DEVPROPTYPE, die den Typ der in Data gespeicherten Daten angibt.

[in] Size

Die Größe des Puffers in Bytes, auf den daten verweist.

[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-Werte zurück.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

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 Einheitliche Geräteeigenschaftenmodell.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.13
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL APC_LEVEL

Weitere Informationen

WdfDeviceAssignInterfaceProperty