IOCTL_HID_GET_PRODUCT_STRING IOCTL (hidclass.h)

Artigo
02/26/2024

A solicitação IOCTL_HID_GET_PRODUCT_STRING obtém a cadeia de caracteres inserida de uma coleção de nível superior que identifica o produto do fabricante. A cadeia de caracteres recuperada é uma cadeia de caracteres largos terminada em NULL em um formato legível por humanos.

Para obter informações gerais sobre dispositivos HIDClass [Coleções HID(/windows-hardware/drivers/hid/hid-collections).

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Parameters.DeviceIoControl.OutputBufferLength no local da pilha de E/S do IRP indica o tamanho, em bytes, do buffer de saída. Se o buffer de saída não for grande o suficiente para manter toda a cadeia de caracteres inserida terminada em NULL, a solicitação não retornará nada no buffer de saída.

Comprimento do buffer de entrada

O número máximo possível de caracteres em uma cadeia de caracteres inserida é específico do dispositivo. Para dispositivos USB, o comprimento máximo da cadeia de caracteres é de 126 caracteres largos (sem incluir o caractere NULL de terminação).

Buffer de saída

Irp->MdlAddress aponta para um buffer para receber a cadeia de caracteres de ID do produto (uma cadeia de caracteres largos terminada em NULL).

Comprimento do buffer de saída

O comprimento de uma cadeia de caracteres largos terminada em NULL. O buffer fornecido deve ser <= 4093 bytes (2^12 – 3).

Bloco de status

O driver de classe HID define 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 erro. Caso contrário, ele será definido como um código de erro NTSTATUS apropriado.