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 。 否則，請將 Flags 設定為零。

[in] Type

將此參數設定為 DEVPROPTYPE 值，指定 數據 緩衝區中提供之數據類型。

[in] Size

指定 Data 所指向緩衝區的大小，以位元組為單位。

[in, optional] Data

裝置介面屬性數據的指標。 將此參數設定為 NULL ，以刪除指定的屬性。 如果 Data 為非 NULL，則例程會儲存屬性值的內部複本。 數據所指向的緩衝區不需要在呼叫傳回之後維持有效狀態。

傳回值

如果呼叫成功，IoSetDeviceInterfacePropertyData 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回碼 Description
STATUS_UNSUCCESSFUL 指定的 LCID 值無效。
STATUS_NOT_IMPLEMENTED 不支援指定的屬性。

備註

內核模式驅動程式會使用 IoSetDeviceInterfacePropertyData 例程來修改定義為 統一裝置屬性模型一部分的裝置介面屬性。 如需裝置介面屬性的詳細資訊，請參閱 裝置屬性。

驅動程式可以使用 IoGetDeviceInterfacePropertyData 例程來取得裝置介面屬性的目前值。

IoSetDeviceInterfacePropertyData 的呼叫端必須在 IRQL <= APC_LEVEL系統線程的內容中執行。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 8 和更新版本的 Windows。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

DEVPROPKEY

DEVPROPTYPE

IoGetDeviceInterfacePropertyData