função HidD_GetSerialNumberString (hidsdi.h)

Artigo
02/29/2024

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