Compartir a través de

función USBD_IsInterfaceVersionSupported (usbdlib.h)

  • Artículo

Un controlador de cliente USB llama a la rutina USBD_IsInterfaceVersionSupported para comprobar si la pila de controladores USB subyacente admite una versión de interfaz USBD determinada.

Sintaxis

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

Parámetros

[in] USBDHandle

Identificador USBD recuperado por el controlador cliente en una llamada anterior a la rutina USBD_CreateHandle .

[in] USBDInterfaceVersion

Valor LONG que representa la versión de la interfaz USBD para comprobar la pila de controladores USB. Entre los valores posibles se incluyen USBD_INTERFACE_VERSION_602 o USBD_INTERFACE_VERSION_600. Para obtener más información, vea la sección Comentarios.

Valor devuelto

USBD_IsInterfaceVersionSupported devuelve TRUE si la pila de controladores USB admite la versión especificada de la interfaz USBD; False en caso contrario. Para obtener más información, vea la sección Comentarios.

Comentarios

La pila de controladores USB cargada para un dispositivo depende de la versión de Windows, el hardware del controlador de host y el dispositivo USB. Windows 7 y versiones anteriores de Windows admiten USBD_INTERFACE_VERSION_600. Las versiones de la interfaz USBD, compatibles con la pila de controladores de Windows 8, se USBD_INTERFACE_VERSION_602 y USBD_INTERFACE_VERSION_600. Un controlador de cliente USB rara vez necesita conocer la versión de la interfaz de la pila de controladores subyacente. En los casos en los que se requiera dicha información, el controlador cliente puede llamar a la rutina USBD_IsInterfaceVersionSupported para comprobar si la pila de controladores subyacente admite una versión de interfaz determinada. Por ejemplo, el controlador cliente llama a USBD_IsInterfaceVersionSupported para determinar si la pila de controladores admite USBD_INTERFACE_VERSION_602. Si admite esa versión, la rutina devuelve TRUE.

La rutina requiere un identificador USBD válido (obtenido en una llamada anterior a USBD_CreateHandle). USBD_IsInterfaceVersionSupported solo pueden llamar los controladores de cliente que tienen como destino Windows Vista y versiones posteriores de Windows. Esos controladores cliente deben obtener el Kit de controladores de Windows (WDK) para Windows 8 con el fin de llamar correctamente a las rutinas. USBD_IsInterfaceVersionSupported reemplaza la rutina de USBD_GetUSBDIVersion .

La versión de la interfaz USBD no indica las funcionalidades admitidas por la pila de controladores USB. Por ejemplo, solo porque la pila de controladores subyacente admite USBD_INTERFACE_VERSION_602, el controlador cliente no debe suponer que el controlador puede usar la funcionalidad de secuencias estáticas. Esto se debe a que, aunque la pila de controladores admite la funcionalidad, es posible que el hardware del controlador de host o el dispositivo USB no admitan secuencias. Para determinar si la pila de controladores USB admite una determinada funcionalidad, llame a USBD_QueryUsbCapability.

Requisitos

Requisito Value
Cliente mínimo compatible Requiere WDK para Windows 8. Tiene como destino Windows Vista y versiones posteriores del sistema operativo Windows.
Plataforma de destino Escritorio
Encabezado usbdlib.h
Library Usbdex.lib
IRQL PASSIVE_LEVEL