HidD_GetPreparsedData函式 (hidsdi.h)

  • 發行項

HidD_GetPreparsedData例程會傳回最上層集合的預先分析數據。

語法

BOOLEAN HidD_GetPreparsedData(
  [in]  HANDLE               HidDeviceObject,
  [out] PHIDP_PREPARSED_DATA *PreparsedData
);

參數

[in] HidDeviceObject

指定最上層集合的開啟句柄。

[out] PreparsedData

例程配置的緩衝區位址的指標，該緩衝區包含集合在 _HIDP_PREPARSED_DATA 結構中預先剖析的數據。

傳回值

如果成功，HidD_GetPreparsedData 傳回 TRUE ;否則會傳回 FALSE。 使用 GetLastError 取得擴充的錯誤資訊。

備註

只有使用者模式應用程式可以呼叫 HidD_GetPreparsedData。 核心模式驅動程式可以使用 IOCTL_HID_GET_COLLECTION_DESCRIPTOR 要求。

當應用程式不再需要預先分析的數據時，應該呼叫 HidD_FreePreparsedData 以釋放預先分析的數據緩衝區。

如需詳細資訊，請參閱 HID 集合。

規格需求

需求 值
最低支援的用戶端 可在 Windows 2000 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 hidsdi.h (包含 Hidsdi.h)
程式庫 Hid.lib
Dll Hid.dll

另請參閱

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA