Partilhar via

IOCTL_HID_GET_REPORT_DESCRIPTOR IOCTL (hidport.h)

  • Artigo

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 >UserBuffer.

Comprimento do buffer de entrada

O tamanho de OutputBufferLength.

Buffer de saída

O minidriver HID preenche o buffer em > 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:

  • de Informações é definido como o número de bytes transferidos do dispositivo.
  • 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 de status esteja correto e não altere o conteúdo do campo Status.

Requisitos

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

Consulte também

IOCTL_GET_PHYSICAL_DESCRIPTOR

IOCTL_HID_GET_DEVICE_DESCRIPTOR