função HidD_GetSerialNumberString (hidsdi.h)
A rotina HidD_GetSerialNumberString retorna a cadeia de caracteres inserida de uma coleção 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 no Buffer. Se o buffer não for grande o suficiente para retornar toda a cadeia de caracteres inserida terminada em NULL, a rotina não retornará nada no buffer. O buffer fornecido deve ser <= 4093 bytes (2^12 – 3).
Retornar valor
HidD_GetSerialNumberString retornará TRUE se retornar com êxito toda a cadeia de caracteres inserida terminada em NULL. Caso contrário, a rotina retornará FALSE. Use GetLastError para obter informações de erro estendidas.
Comentários
Somente aplicativos de 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 largos (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 código de erro ERROR_GEN_FAILURE (0x0000001f)
Para obter mais informações, consulte Coleções HID.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | hidsdi.h (inclua Hidsdi.h) |
| Biblioteca | Hid.lib |
| DLL | Hid.dll |