Compartilhar via


IOCTL_HID_GET_REPORT_DESCRIPTOR IOCTL (hidport.h)

A solicitação IOCTL_HID_GET_REPORT_DESCRIPTOR obtém o descritor de relatório para um dispositivo HIDClass.

Para obter informações gerais sobre dispositivos HIDClass, consulte Coleções HID.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Parameters.DeviceIoControl.OutputBufferLength especifica o comprimento, em bytes, do buffer bloqueado em Irp-UserBuffer>.

Comprimento do buffer de entrada

O tamanho de OutputBufferLength.

Buffer de saída

O minidriver HID preenche o buffer em Irp-UserBuffer> com o descritor de relatório.

Comprimento do buffer de saída

O tamanho do descritor de relatório.

Bloco de status

Os minidrivers HID que executam a E/S para o dispositivo definem os seguintes campos de Irp-IoStatus>:

  • As informações são definidas como o número de bytes transferidos do dispositivo.
  • O status será definido como STATUS_SUCCESS se a transferência for concluída sem erros. Caso contrário, ele será definido como um código de erro NTSTATUS apropriado.
Os minidrivers HID que chamam outros drivers com esse IOCTL para realizar a E/S em seu dispositivo devem garantir que o campo Informações do bloco status esteja correto e não altere o conteúdo do campo Status.

Requisitos

Requisito Valor
Cabeçalho hidport.h (inclua Hidport.h)

Confira também

IOCTL_GET_PHYSICAL_DESCRIPTOR

IOCTL_HID_GET_DEVICE_DESCRIPTOR