共用方式為

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

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

[out] Type

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

傳回值

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

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

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

言論

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

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

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

要求

要求 價值
最低支援的用戶端 Windows 8.1
目標平臺 普遍
最低 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