função HidD_GetManufacturerString (hidsdi.h)
A rotina de HidD_GetManufacturerString retorna uma cadeia de caracteres inserida coleção de nível superior que identifica o fabricante.
Sintaxe
BOOLEAN HidD_GetManufacturerString(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Parâmetros
[in] HidDeviceObject
Especifica um identificador aberto para uma coleção de nível superior.
[out] Buffer
Ponteiro para um buffer alocado por chamador que a rotina usa para retornar a cadeia de caracteres do fabricante da coleção. A rotina retorna uma cadeia de caracteres largos terminada em NULL em um formato legível por humanos.
[in] BufferLength
Especifica o comprimento, em bytes, de um buffer alocado pelo chamador fornecido em buffer. Se o buffer não for grande o suficiente para retornar toda a cadeia de caracteres inserida terminada por NULL, a rotina não retornará nada no buffer. O buffer fornecido deve ser <= 4093 bytes (2^12 – 3).
Valor de retorno
HidD_HidD_GetManufacturerString retornará verdadeiro se retornar toda a cadeia de caracteres inserida terminada por NULL. Caso contrário, a rotina retornará FALSE . Use GetLastError para obter informações de erro estendidas.
Observações
Somente aplicativos no modo de usuário podem chamar HidD_GetManufacturerString. Os drivers no modo kernel podem usar uma solicitação IOCTL_HID_GET_MANUFACTURER_STRING.
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 de largura (sem incluir o caractere NULL de terminação).
Se o buffer fornecido não for <= 4093 bytes (2^12 – 3), a chamada poderá falhar (dependendo do protocolo subjacente, HID/Bluetooth/SPI) com ERROR_GEN_FAILURE de código de erro (0x0000001f).
Para obter mais informações, consulte coleções HID.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Disponível no Windows 2000 e versões posteriores do Windows. |
da Plataforma de Destino | Universal |
cabeçalho | hidsdi.h (inclua Hidsdi.h) |
biblioteca | Hid.lib |
de DLL | Hid.dll |