Share via

WdfDeviceQueryInterfaceProperty 函式 (wdfdevice.h)

  • 發行項

[僅適用於 UMDF]

WdfDeviceQueryInterfaceProperty 方法會擷取指定的裝置介面屬性。

語法

NTSTATUS WdfDeviceQueryInterfaceProperty(
  [in]  WDFDEVICE                           Device,
  [in]  PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]  ULONG                               BufferLength,
  [out] PVOID                               PropertyBuffer,
  [out] PULONG                              ResultLength,
  [out] PDEVPROPTYPE                        Type
);

參數

[in] Device

架構裝置物件的句柄。

[in] PropertyData

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

[in] BufferLength

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

[out] PropertyBuffer

接收要求之裝置介面屬性之呼叫端配置的緩衝區指標。 如果 BufferLength 參數為零，指標可以是 NULL。

[out] ResultLength

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

[out] Type

DEVPROPTYPE 型別變數的指標，可識別 WdfDeviceQueryInterfaceProperty 儲存在 PropertyBuffer 所指向之緩衝區中的屬性數據類型。

傳回值

如果 WdfDeviceQueryInterfaceProperty 方法未發生任何錯誤，則會傳回STATUS_SUCCESS。 其他傳回值包括：

傳回碼 Description
STATUS_BUFFER_TOO_SMALL
 輸入緩衝區太小而無法接收資訊。
STATUS_INVALID_PARAMETER_2
 指定的參數值無效。
 

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

備註

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

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

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

規格需求

需求 值
最低支援的用戶端 Windows 8.1
目標平台 Universal
最低UMDF版本 2.0
標頭 wdfdevice.h (包含 Wdf.h)
程式庫 WUDFx02000.lib
Dll WUDFx02000.dll
IRQL PASSIVE_LEVEL

另請參閱

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceAssignInterfaceProperty