共用方式為

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

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

[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 值。 此例程可能會傳回下列其中一個值：

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

言論

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

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

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

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

另請參閱

DEVPROPKEY

DEVPROPTYPE

IoSetDevicePropertyData