IoSetDeviceInterfacePropertyData-Funktion (wdm.h)

  • Artikel

Die IoSetDeviceInterfacePropertyData-Routine ändert den aktuellen Wert einer Geräteschnittstelleneigenschaft.

Syntax

NTSTATUS IoSetDeviceInterfacePropertyData(
  [in]           PUNICODE_STRING  SymbolicLinkName,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           LCID             Lcid,
  [in]           ULONG            Flags,
  [in]           DEVPROPTYPE      Type,
  [in]           ULONG            Size,
  [in, optional] PVOID            Data
);

Parameter

[in] SymbolicLinkName

Ein Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle instance identifiziert. Diese Zeichenfolge wurde aus einem vorherigen Aufruf der Routine IoGetDeviceInterfaces, IoGetDeviceInterfaceAlias oder IoRegisterDeviceInterface abgerufen.

[in] PropertyKey

Ein Zeiger auf eine DEVPROPKEY-Struktur , die den Eigenschaftenschlüssel der Geräteschnittstelle enthält.

[in] Lcid

Gibt einen Gebietsschemabezeichner an. Legen Sie diesen Parameter entweder auf einen sprachspezifischen LCID-Wert oder auf LOCALE_NEUTRAL fest. Die LOCALE_NEUTRAL LCID gibt an, dass die Eigenschaft sprachneutral ist (d. a. nicht sprachspezifisch). Legen Sie diesen Parameter nicht auf LOCALE_SYSTEM_DEFAULT oder LOCALE_USER_DEFAULT fest. Weitere Informationen zu sprachspezifischen LCID-Werten finden Sie unter LCID-Struktur.

[in] Flags

Legen Sie diesen Parameter auf PLUGPLAY_PROPERTY_PERSISTENT fest, wenn der von dieser Routine festgelegte Eigenschaftswert bei Computerneustarts beibehalten werden soll. Legen Sie andernfalls Flags auf 0 fest.

[in] Type

Legen Sie diesen Parameter auf den WERT DEVPROPTYPE fest, der den Typ der Daten angibt, die im Datenpuffer bereitgestellt werden.

[in] Size

Gibt die Größe des Puffers in Bytes an, auf den Data verweist.

[in, optional] Data

Ein Zeiger auf die Eigenschaftendaten der Geräteschnittstelle. Legen Sie diesen Parameter auf NULL fest, um die angegebene Eigenschaft zu löschen. Wenn Data nicht NULL ist, speichert die Routine eine interne Kopie des Eigenschaftswerts. Der Puffer, auf den von Data verwiesen wird, muss nicht gültig bleiben, nachdem der Aufruf zurückgegeben wird.

Rückgabewert

IoSetDeviceInterfacePropertyData gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Mögliche Fehlerrückgabewerte umfassen die folgenden status-Codes.

Rückgabecode Beschreibung
STATUS_UNSUCCESSFUL Der angegebene LCID-Wert ist ungültig.
STATUS_NOT_IMPLEMENTED Die angegebene Eigenschaft wird nicht unterstützt.

Hinweise

Kernelmodustreiber verwenden die IoSetDeviceInterfacePropertyData-Routine , um Geräteschnittstelleneigenschaften zu ändern, die als Teil des einheitlichen Geräteeigenschaftenmodells definiert sind. Weitere Informationen zu Geräteschnittstelleneigenschaften finden Sie unter Geräteeigenschaften.

Treiber können die IoGetDeviceInterfacePropertyData-Routine verwenden, um den aktuellen Wert für eine Geräteschnittstelleneigenschaft abzurufen.

Aufrufer von IoSetDeviceInterfacePropertyData müssen unter IRQL <= APC_LEVEL im Kontext eines Systemthreads ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar für Windows 8 und höhere Versionen von Windows.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Weitere Informationen

DEVPROPKEY

DEVPROPTYPE

IoGetDeviceInterfacePropertyData