共用方式為


IWDFUsbTargetDevice::RetrieveDeviceInformation 方法 (wudfusb.h)

[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,且較新版本的 #DF27641004A7B4ABB91BF6499AD4F80F7 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]

RetrieveDeviceInformation 方法會擷取指定類型的裝置資訊。

語法

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

參數

[in] InformationType

UMDF 驅動程式要求裝置的相關信息類型。

[in, out] BufferLength

在輸入時,變數的指標包含 BufferRetrieveDeviceInformation 所提供的緩衝區大小,以位元組為單位。 在輸出上,此參數包含 Buffer 所需的 RetrieveDeviceInformation 大小。

[out] Buffer

接收包含裝置信息的緩衝區的指標。

傳回值

RetrieveDeviceInformation 會傳回下列其中一個值:

傳回碼 Description
S_OK

RetrieveDeviceInformation 已成功擷取裝置資訊。

E_OUTOFMEMORY

RetrieveDeviceInformation 發生配置失敗。

在 Winerror.h 中定義的錯誤碼
這個值對應於 WinUsb API 傳回的錯誤碼。

備註

如需 UMDF 驅動程式可以針對 InformationType 參數傳遞之有效資訊類型的詳細資訊,請參閱 WinUsb_QueryDeviceInformation 函式。

如果 InformationType 是DEVICE_SPEED (0x01) ,在成功傳回時, Buffer 會指出裝置的作業速度。 0x03表示高速或更高;0x01表示全速或更低。

RetrieveDeviceInformation 方法會產生 UMDF 要求,並以同步方式將要求傳送至 I/O 目標。

範例

如需如何使用RetrieveDeviceInformation 方法的程式代碼範例,請參閱 IWDFUsbTargetPipe::SetPipePolicy

規格需求

需求
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平台 桌面
最低UMDF版本 1.5
標頭 wudfusb.h (包括 Wudfusb.h)
Dll WUDFx.dll

另請參閱

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation