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