LPGET_STRING

9/8/2008

Essa função obtém um seqüência de caracteres de um dispositivo HID.

Syntax

typedef DWORD (*LPGET_STRING) (
  HID_HANDLE hDevice,
  HID_STRING_TYPE stringType,
  DWORD dwIdx,
  LPWSTR pszBuffer,
  DWORD cchBuffer,
  PDWORD pcchActual
);

Parameters

• hDevice
  [no] Identificador para um dispositivo HID.

• stringType
  [no] Seqüência de caracteres tipo para obter. O HID_STRING_TYPE enumeração contém os tipos de seqüências de caracteres.

• dwIdx
  [no] Usado quando stringType é definido como HID_STRING_INDEXED.

• pszBuffer
  [in, Out] Definido como NULL para get do o seqüência de caracteres caractere contagem e, em seguida, adicionar um para o NULL terminador. Caso contrário, esta é a reserva que armazena o seqüência de caracteres obtido o dispositivo HID.

• cchBuffer
  [no] Número de caracteres que caberá em pszBuffer, incluindo o NULL terminador.

• pcchActual
  [no] Número de caracteres de seqüência de caracteres, não incluindo o NULL terminador.

Return Value

A seguinte tabela mostra os possíveis valores de retorno.

Valor	Descrição
ERROR_GEN_FAILURE	Informações dispositivo USB não foi obtidas.
ERROR_NOT_FOUND	Tipo de seqüência de caracteres não foi obtido porque o tipo seqüência de caracteres especificado não existe.
ERROR_INVALID_PARAMETER	Índice de seqüência de caracteres era muito grande ou ocorreu uma exceção ao escrever a reserva do usuário.
ERROR_SUCCESS	Função retornado com êxito.

Requirements

Header	hiddi.h
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

HID_STRING_TYPE