IoSetDeviceInterfacePropertyData-Funktion (wdm.h)
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 |