Compartilhar via


função HidD_GetPreparsedData (hidsdi.h)

A rotina HidD_GetPreparsedData retorna os dados pré-preparadosde uma coleção de nível superior.

Sintaxe

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

Parâmetros

[in] HidDeviceObject

Especifica um identificador aberto para uma coleção de nível superior.

[out] PreparsedData

Ponteiro para o endereço de um buffer alocado de rotina que contém os dados pré-preparados de uma coleção em uma estrutura _HIDP_PREPARSED_DATA .

Retornar valor

HidD_GetPreparsedDataretornará TRUE se tiver êxito; caso contrário, retornará FALSE. Use GetLastError para obter informações de erro estendidas.

Comentários

Somente aplicativos de modo de usuário podem chamar HidD_GetPreparsedData. Os drivers no modo kernel podem usar uma solicitação de IOCTL_HID_GET_COLLECTION_DESCRIPTOR .

Quando um aplicativo não exige mais os dados pré-preparados, ele deve chamar HidD_FreePreparsedData para liberar o buffer de dados pré-preparado.

Para obter mais informações, consulte Coleções HID.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho hidsdi.h (inclua Hidsdi.h)
Biblioteca Hid.lib
DLL Hid.dll

Confira também

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA