共用方式為

WdfDeviceQueryPropertyEx 函式 （wdfdevice.h）

  • 發行項

[適用於 KMDF 和 UMDF]

WdfDeviceQueryPropertyEx 方法會擷取指定的裝置屬性。

語法

NTSTATUS WdfDeviceQueryPropertyEx(
  [in]  WDFDEVICE                 Device,
  [in]  PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]  ULONG                     BufferLength,
  [out] PVOID                     PropertyBuffer,
  [out] PULONG                    RequiredSize,
  [out] PDEVPROPTYPE              Type
);

參數

[in] Device

架構裝置物件的句柄。

[in] DeviceProperty

識別要擷取之裝置屬性之 WDF_DEVICE_PROPERTY_DATA 結構的指標。

[in] BufferLength

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

[out] PropertyBuffer

呼叫端提供的指標，指向接收所要求資訊的呼叫端配置緩衝區。 如果 bufferLength 參數為零，則指標可以 NULL。

[out] RequiredSize

呼叫端提供的位置，傳回時會包含方法儲存在 PropertyBuffer 中之資訊的大小，以位元組為單位。 如果函式的傳回值是 STATUS_BUFFER_TOO_SMALL，這個位置會收到所需的緩衝區大小。

[out] Type

DEVPROPTYPE 變數的指標。 如果方法成功，傳回此參數時，會包含儲存在 PropertyBuffer 屬性資料的屬性值，。

傳回值

如果作業成功，WdfDeviceQueryPropertyEx 會傳回STATUS_SUCCESS。 其他傳回值包括：

傳回碼 描述
STATUS_BUFFER_TOO_SMALL
 提供的緩衝區太小，無法接收資訊。
STATUS_INVALID_PARAMETER
 指定的 DeviceProperty 值無效。
 

方法可能會 傳回其他NTSTATUS 值。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

言論

您可以使用 WdfDeviceQueryPropertyEx 擷取透過統一屬性模型公開的任何屬性，而 WdfDeviceQueryProperty 方法只允許查詢統一屬性模型的子集。

在接收裝置屬性數據之前，驅動程式通常會呼叫 WdfDeviceQueryPropertyEx 方法，以取得所需的緩衝區大小。 針對某些屬性，數據大小可以在傳回所需的大小和驅動程式再次呼叫 WdfDeviceQueryPropertyEx 時變更。 因此，驅動程式應該在迴圈內呼叫 WdfDeviceQueryPropertyEx，直到傳回狀態未STATUS_BUFFER_TOO_SMALL為止。

最好只有在已知且未變更所需的緩衝區大小時，才使用 WdfDeviceQueryPropertyEx，因為在此情況下，驅動程式必須只呼叫 WdfDeviceQueryPropertyEx 一次。 如果所需的緩衝區大小未知或不同，驅動程式應該呼叫 WdfDeviceAllocAndQueryPropertyEx。

如需相關方法的相關信息，請參閱 存取統一裝置屬性模型。

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.13
最低 UMDF 版本 2.0
標頭 wdfdevice.h （包括 Wdf.h）
連結庫 Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF）
IRQL APC_LEVEL

另請參閱

WdfDeviceQueryInterfaceProperty

WdfDeviceQueryProperty