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
識別裝置介面實例之字串的指標。 此字串是從先前呼叫 IoGetDeviceInterfaces、 IoGetDeviceInterfaceAlias 或 IoRegisterDeviceInterface 例程取得。
[in] PropertyKey
包含裝置介面屬性鍵 之 DEVPROPKEY 結構的指標。
[in] Lcid
指定地區設定標識碼。 將此參數設定為語言特定的 LCID 值或 LOCALE_NEUTRAL。 LOCALE_NEUTRAL LCID 指定屬性是非語言中性 (，而不是任何語言) 。 請勿將此參數設定為 LOCALE_SYSTEM_DEFAULT 或 LOCALE_USER_DEFAULT。 如需語言特定 LCID 值的詳細資訊，請參閱 LCID 結構。
Flags
保留供系統使用。 驅動程式應該將此值設定為零。
[in] Size
指定 Data 所指向緩衝區的大小，以位元組為單位。
[out] Data
呼叫端配置的緩衝區指標，例程會將裝置介面屬性數據寫入其中。
[out] RequiredSize
IoGetDeviceInterfacePropertyData 寫入屬性數據所需大小的 ULONG 變數指標。 如果例程成功，則必要的大小值是例程寫入 Data 所指向 之輸出緩衝區的位元組數目。 如果例程傳回STATUS_BUFFER_TOO_SMALL，則必要的大小值是呼叫端應該配置給這個屬性值的緩衝區大小。
[out] Type
DEVPROPTYPE 變數的指標。 如果 IoGetDeviceInterfacePropertyData 成功擷取屬性數據，例程會將屬性值寫入這個變數。 這個值表示 數據緩衝區中的 屬性數據類型。
傳回值
如果成功，IoGetDeviceInterfacePropertyData 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
| 傳回碼 | Description |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Data 指向的緩衝區太小，無法包含屬性數據。 *RequiredSize 包含必要的緩衝區長度。 |
| STATUS_UNSUCCESSFUL | 指定的 LCID 值無效。 |
| STATUS_NOT_IMPLEMENTED | 不支援指定的屬性。 |
備註
內核模式驅動程式會使用 IoGetDeviceInterfacePropertyData 例程來擷取定義為 統一裝置屬性模型一部分的裝置介面屬性。 如需裝置介面屬性的詳細資訊，請參閱 裝置屬性。
驅動程式可以使用 IoSetDeviceInterfacePropertyData 例程來修改裝置介面屬性。
IoGetDeviceInterfacePropertyData 的呼叫端必須在 IRQL = PASSIVE_LEVEL系統線程的內容中執行。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 及更新版本的 Windows 中提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |