função HidD_GetSerialNumberString (hidsdi.h)
A rotina HidD_GetSerialNumberString retorna a cadeia de caracteres inserida de uma coleção de de nível superior que identifica o número de série do dispositivo físico da coleção.
Sintaxe
BOOLEAN HidD_GetSerialNumberString(
[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 pelo chamador que a rotina usa para retornar a cadeia de caracteres de número de série solicitada. A rotina retorna uma cadeia de caracteres largos terminada em NULL.
[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_GetSerialNumberString retorna verdadeiro se retornar com êxito 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_GetSerialNumberString. Os drivers no modo kernel podem usar IOCTL_HID_GET_SERIALNUMBER_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 |