Compartilhar via


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

Consulte também

HidD_GetIndexedString

HidD_GetPhysicalDescriptor

HidD_GetProductString

HidD_GetSerialNumberString

IOCTL_HID_GET_INDEXED_STRING

IOCTL_HID_GET_MANUFACTURER_STRING

IOCTL_HID_GET_PRODUCT_STRING

IOCTL_HID_GET_SERIALNUMBER_STRING