ioGetDevicePropertyData 函式 (wdm.h)

  • 發行項

IoGetDevicePropertyData 例程會擷取裝置屬性目前的設定。

語法

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

參數

[in] Pdo

正在查詢之裝置的實體裝置物件指標 (PDO) 。

[in] PropertyKey

指定裝置屬性索引鍵 之 DEVPROPKEY 結構的指標。

[in] Lcid

地區設定標識碼。 將此參數設定為語言特定的 LCID 值或 LOCALE_NEUTRAL。 LOCALE_NEUTRAL LCID 指定屬性是非語言中性 (，而不是任何語言) 。 請勿將此參數設定為 LOCALE_SYSTEM_DEFAULT 或 LOCALE_USER_DEFAULT。 如需語言特定 LCID 值的詳細資訊，請參閱 LCID 結構。

Flags

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

[in] Size

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

[out] Data

裝置屬性數據的指標。

[out] RequiredSize

ULONG 的指標，可接收 在 Data 傳回之屬性資訊的大小。 如果 IoGetDevicePropertyData 傳回STATUS_BUFFER_TOO_SMALL，呼叫端可以使用此值來配置正確大小的緩衝區。

[out] Type

DEVPROPTYPE 值的指標。 如果 IoGetDevicePropertyData 成功完成，例程會使用 Type 來提供 Data 緩衝區中傳回的數據類型。

傳回值

IoGetDevicePropertyData 會傳回 NTSTATUS 值。 此例程可能會傳回下列其中一個值：

傳回碼 Description
STATUS_SUCCESS
 作業成功。 數據緩衝區包含擷取的數據。 **Type* 包含所擷取數據的型別。
STATUS_BUFFER_TOO_SMALL
 數據緩衝區太小。 **RequiredSize* 包含必要的緩衝區長度。
STATUS_OBJECT_NAME_NOT_FOUND
 找不到指定的裝置屬性。

備註

內核模式驅動程式會使用 IoGetDevicePropertyData 例程來擷取定義為統一裝置屬性模型的一部分的裝置屬性。

若要查看這個例程可用的屬性類型，請參閱 的DEVPROP_TYPE_*DEVPROP_TYPE_BYTE和相鄰頁面。

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

IoGetDevicePropertyData 的呼叫端必須在 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)

另請參閱

DEVPROPKEY

DEVPROPTYPE

IoSetDevicePropertyData