Compartilhar via

Função USBD_IsInterfaceVersionSupported (usbdlib.h)

  • Artigo

A rotina de USBD_IsInterfaceVersionSupported é chamada por um driver de cliente USB para marcar se a pilha de driver USB subjacente dá suporte a uma versão específica da interface USBD.

Sintaxe

BOOLEAN USBD_IsInterfaceVersionSupported(
  [in] USBD_HANDLE USBDHandle,
  [in] ULONG       USBDInterfaceVersion
);

Parâmetros

[in] USBDHandle

Identificador USBD recuperado pelo driver cliente em uma chamada anterior para a rotina de USBD_CreateHandle .

[in] USBDInterfaceVersion

Um valor LONG que representa a versão da interface USBD para marcar na pilha do driver USB. Os valores possíveis incluem USBD_INTERFACE_VERSION_602 ou USBD_INTERFACE_VERSION_600. Para obter mais informações, consulte Comentários.

Retornar valor

USBD_IsInterfaceVersionSupported retornará TRUE se a versão da interface USBD especificada for compatível com a pilha de driver USB; FALSE caso contrário. Para obter mais informações, consulte Comentários.

Comentários

A pilha de driver USB carregada para um dispositivo depende da versão do Windows, do hardware do controlador de host e do dispositivo USB. O Windows 7 e versões anteriores do Windows dão suporte a USBD_INTERFACE_VERSION_600. As versões da interface USBD, compatíveis com a pilha do driver Windows 8, são USBD_INTERFACE_VERSION_602 e USBD_INTERFACE_VERSION_600. Um driver cliente USB raramente precisa saber sobre a versão da interface da pilha de driver subjacente. Nos casos em que essas informações são necessárias, o driver do cliente pode chamar a rotina USBD_IsInterfaceVersionSupported para marcar se uma versão de interface específica tem suporte na pilha de driver subjacente. Por exemplo, o driver do cliente chama USBD_IsInterfaceVersionSupported para determinar se a pilha de driver dá suporte a USBD_INTERFACE_VERSION_602. Se ele der suporte a essa versão, a rotina retornará TRUE.

A rotina requer um identificador USBD válido (obtido em uma chamada anterior para USBD_CreateHandle). USBD_IsInterfaceVersionSupported só pode ser chamado por drivers de cliente direcionados ao Windows Vista e versões posteriores do Windows. Esses drivers de cliente devem obter o WDK (Windows Driver Kit) para Windows 8 para chamar as rotinas com êxito. USBD_IsInterfaceVersionSupported substitui a rotina de USBD_GetUSBDIVersion .

A versão da interface USBD não indica os recursos compatíveis com a pilha do driver USB. Por exemplo, apenas porque a pilha de driver subjacente dá suporte a USBD_INTERFACE_VERSION_602, o driver cliente não deve assumir que o driver pode usar a funcionalidade de fluxos estáticos. Isso ocorre porque, embora a pilha de driver dê suporte à funcionalidade, o hardware do controlador de host ou o dispositivo USB podem não dar suporte a fluxos. Para determinar se a pilha de driver USB dá suporte a uma determinada funcionalidade, chame USBD_QueryUsbCapability.

Requisitos

Requisito Valor
Cliente mínimo com suporte Requer WDK para Windows 8. Tem como destino o Windows Vista e versões posteriores do sistema operacional Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho usbdlib.h
Biblioteca Usbdex.lib
IRQL PASSIVE_LEVEL