função USBD_IsInterfaceVersionSupported (usbdlib.h)

Artigo
02/07/2025

A rotina de USBD_IsInterfaceVersionSupported é chamada por um driver cliente USB para verificar 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 a ser verificada 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.

Valor de retorno

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

Observações

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 de driver do 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 cliente pode chamar a rotina USBD_IsInterfaceVersionSupported para verificar se uma versão de interface específica tem suporte pela pilha de driver subjacente. Por exemplo, o driver 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 cliente direcionados ao Windows Vista e versões posteriores do Windows. Esses drivers 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 de 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
de cliente com suporte mínimo	Requer WDK para Windows 8. Direciona o Windows Vista e versões posteriores do sistema operacional Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	usbdlib.h
biblioteca	Usbdex.lib
IRQL	PASSIVE_LEVEL

Compartilhar via