IoSetDeviceInterfacePropertyData 函式 (wdm.h)
IoSetDeviceInterfacePropertyData 例程會修改 裝置介面屬性的目前值,。
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
);
[in] SymbolicLinkName
識別裝置介面實例之字串的指標。 此字串是從先前呼叫 ioGetDeviceInterfaces、IoGetDeviceInterfaceAlias或 IoRegisterDeviceInterface 例程取得。
[in] PropertyKey
包含裝置介面屬性索引鍵之 DEVPROPKEY 結構的指標。
[in] Lcid
指定地區設定標識碼。 將此參數設定為語言特定的 LCID 值,或將 設定為 LOCALE_NEUTRAL。 LOCALE_NEUTRAL LCID 指定屬性是語言中性(也就是不是任何語言特有的)。 請勿將此參數設定為 LOCALE_SYSTEM_DEFAULT 或 LOCALE_USER_DEFAULT。 如需語言特定 LCID 值的詳細資訊,請參閱 LCID 結構。
[in] Flags
如果這個例程所設定的屬性值應該在電腦重新啟動時保存,請將此參數設定為 PLUGPLAY_PROPERTY_PERSISTENT。 否則,請將 旗標 設為零。
[in] Type
將此參數設定為 DEVPROPTYPE 值,指定 Data 緩衝區中提供之數據類型。
[in] Size
指定 數據 指向之緩衝區的大小,以位元組為單位。
[in, optional] Data
裝置介面屬性數據的指標。 將此參數設定為 NULL,以刪除指定的屬性。 如果 數據 非NULL,則例程會儲存屬性值的內部複本。 Data 所指向的緩衝區不需要在呼叫傳回之後保持有效。
如果呼叫成功,IoSetDeviceInterfacePropertyData 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
傳回碼 | 描述 |
---|---|
STATUS_UNSUCCESSFUL | 指定的 LCID 值無效。 |
STATUS_NOT_IMPLEMENTED | 不支援指定的屬性。 |
內核模式驅動程式會使用 IoSetDeviceInterfacePropertyData 例程來修改定義為 統一裝置屬性模型的一部分的裝置介面屬性。 如需裝置介面屬性的詳細資訊,請參閱 裝置屬性。
驅動程式可以使用 IoGetDeviceInterfacePropertyData 例程來取得裝置介面屬性的目前值。
IoSetDeviceInterfacePropertyData 的呼叫者必須在系統線程的內容中於 IRQL <= APC_LEVEL執行。
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 8 和更新版本的 Windows。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |