共用方式為


IoGetDeviceInterfacePropertyData 函式 (wdm.h)

IoGetDeviceInterfacePropertyData 例程會擷取 裝置介面屬性的目前值

語法

NTSTATUS IoGetDeviceInterfacePropertyData(
  [in]  PUNICODE_STRING  SymbolicLinkName,
  [in]  const DEVPROPKEY *PropertyKey,
  [in]  LCID             Lcid,
        ULONG            Flags,
  [in]  ULONG            Size,
  [out] PVOID            Data,
  [out] PULONG           RequiredSize,
  [out] PDEVPROPTYPE     Type
);

參數

[in] SymbolicLinkName

識別裝置介面實例之字串的指標。 此字串是從先前呼叫 ioGetDeviceInterfacesIoGetDeviceInterfaceAliasIoRegisterDeviceInterface 例程取得。

[in] PropertyKey

包含裝置介面屬性索引鍵之 DEVPROPKEY 結構的指標。

[in] Lcid

指定地區設定標識碼。 將此參數設定為語言特定的 LCID 值,或將 設定為 LOCALE_NEUTRALLOCALE_NEUTRAL LCID 指定屬性是語言中性(也就是不是任何語言特有的)。 請勿將此參數設定為 LOCALE_SYSTEM_DEFAULTLOCALE_USER_DEFAULT。 如需語言特定 LCID 值的詳細資訊,請參閱 LCID 結構

Flags

保留供系統使用。 驅動程式應將此值設定為零。

[in] Size

指定 數據 指向之緩衝區的大小,以位元組為單位。

[out] Data

呼叫端配置的緩衝區指標,例程會將裝置介面屬性數據寫入其中。

[out] RequiredSize

ULONG 變數的指標,IoGetDeviceInterfacePropertyData 寫入屬性數據所需的大小。 如果例程成功,所需的大小值就是例程寫入至 Data 指向的輸出緩衝區的位元元數目。 如果例程傳回STATUS_BUFFER_TOO_SMALL,必要的大小值就是呼叫端應該配置給這個屬性值的緩衝區大小。

[out] Type

DEVPROPTYPE 變數的指標。 如果 IoGetDeviceInterfacePropertyData 成功擷取屬性數據,例程會將屬性值寫入此變數。 這個值表示 Data 緩衝區中的屬性數據類型。

傳回值

IoGetDeviceInterfacePropertyData 如果成功,就會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回碼 描述
STATUS_BUFFER_TOO_SMALL Data 指向的緩衝區太小,無法包含屬性數據。 * RequiredSize 包含必要的緩衝區長度。
STATUS_UNSUCCESSFUL 指定的 LCID 值無效。
STATUS_NOT_IMPLEMENTED 不支援指定的屬性。

言論

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

驅動程式可以使用 IoSetDeviceInterfacePropertyData 例程來修改裝置介面屬性。

IoGetDeviceInterfacePropertyData 的呼叫端必須在系統線程的內容中於 IRQL = PASSIVE_LEVEL執行。

要求

要求 價值
最低支援的用戶端 適用於 Windows 8 和更新版本的 Windows。
目標平臺 普遍
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

另請參閱

DEVPROPKEY

DEVPROPTYPE

IoSetDeviceInterfacePropertyData