IOCTL_HID_WRITE_REPORT IOCTL (hidport.h)

Artigo
02/07/2025

A solicitação IOCTL_HID_WRITE_REPORT envia um relatório HID para um dispositivo HIDClass.

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

Código principal

Buffer de entrada

>UserBuffer aponta para uma estrutura de HID_XFER_PACKET que contém os parâmetros e o relatório a serem transmitidos para o dispositivo. Os seguintes membros são usados:

Comprimento do buffer de entrada

O tamanho de uma estrutura HID_XFER_PACKET.

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

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 para o 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.