IoSetDevicePropertyData 函式 (wdm.h)
IoSetDevicePropertyData 例程會修改裝置屬性的目前設定。
語法
NTSTATUS IoSetDevicePropertyData(
[in] PDEVICE_OBJECT Pdo,
[in] const DEVPROPKEY *PropertyKey,
[in] LCID Lcid,
[in] ULONG Flags,
[in] DEVPROPTYPE Type,
[in] ULONG Size,
[in, optional] PVOID Data
);
參數
[in] Pdo
正在查詢之裝置的實體裝置物件指標 (PDO) 。
[in] PropertyKey
指定裝置屬性索引鍵 之 DEVPROPKEY 結構的指標。
[in] Lcid
地區設定標識碼。 將此參數設定為語言特定的 LCID 值或 LOCALE_NEUTRAL。
LOCALE_NEUTRAL LCID 指定屬性是非語言中性 (，而不是任何語言) 。
請勿將此參數設定為 LOCALE_SYSTEM_DEFAULT 或 LOCALE_USER_DEFAULT。
如需語言特定 LCID 值的詳細資訊，請參閱 LCID 結構。
[in] Flags
如果這個例程所設定的屬性值應該在電腦重新啟動之間持續存在，請將此參數設定為 PLUGPLAY_PROPERTY_PERSISTENT 。 否則，請將 Flags 設定為零。
Windows 8和 Windows Server 2012和更新版本的操作系統會將旗標視為一律傳遞PLUGPLAY_PROPERTY_PERSISTENT。
[in] Type
DEVPROPTYPE 值，指定數據緩衝區中提供之數據類型。
[in] Size
Data 所指向緩衝區的大小，以位元組為單位。
[in, optional] Data
裝置屬性數據的指標。 將此參數設定為 NULL ，以刪除指定的屬性。 如果 Data 為非 NULL，則例程會儲存屬性值的內部複本。 數據所指向的緩衝區不需要在呼叫傳回之後維持有效狀態。
傳回值
如果呼叫成功，IoSetDevicePropertyData 會傳回STATUS_SUCCESS，或在失敗時傳回適當的 NTSTATUS 程式代碼。
備註
若要查看這個例程可用的屬性類型，請參閱 的DEVPROP_TYPE_*DEVPROP_TYPE_BYTE和相鄰頁面。
內核模式驅動程式會使用 IoSetDevicePropertyData 例程來修改定義為統一裝置屬性模型一部分的裝置屬性。 如需裝置屬性的詳細資訊，請參閱 裝置屬性。
若要刪除特定地區設定的屬性，請在數據中傳遞語言特定的 LCID 值和 NULL。
若要刪除所有地區設定的屬性，請在 Lcid 中傳遞LOCALE_NEUTRAL，並在數據中傳遞 NULL。
若要修改特定地區設定的屬性，請在數據中傳遞語言特定的 LCID 值，並在數據中傳遞非 NULL。
若要修改所有地區設定的屬性，請在 Lcid 中傳遞LOCALE_NEUTRAL，並在數據中傳遞非 NULL。
從 Windows 8 開始，在 Lcid 中傳遞LOCALE_NEUTRAL Windows Server 2012 會被視為任何其他地區設定。
驅動程式可以使用 IoGetDevicePropertyData 例程來取得裝置屬性的目前值。
IoSetDeviceProperty 的呼叫端必須在 IRQL <= APC_LEVEL系統線程的內容中執行。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows Vista 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm) |