Método IWDFUsbTargetDevice::RetrieveUsbInterface (wudfusb.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método RetrieveUsbInterface recupera la interfaz USB especificada para un dispositivo USB.

Sintaxis

HRESULT RetrieveUsbInterface(
  [in]  UCHAR            InterfaceIndex,
  [out] IWDFUsbInterface **ppUsbInterface
);

Parámetros

[in] InterfaceIndex

Índice de la interfaz que se va a recuperar.

[out] ppUsbInterface

Puntero a una variable que recibe un puntero a la interfaz IWDFUsbInterface especificada para el dispositivo USB.

Valor devuelto

RetrieveUsbInterface devuelve uno de los siguientes valores:

Código devuelto Descripción
S_OK

RetrieveUsbInterface recuperó correctamente la interfaz USB especificada para el dispositivo USB.
E_OUTOFMEMORY

RetrieveUsbInterface encontró un error de asignación.
Código de error definido en Winerror.h
 Este valor corresponde al código de error que devolvió la API winUsb.

Comentarios

El controlador puede llamar al método IWDFUsbTargetDevice::GetNumInterfaces para recuperar el número total de interfaces USB disponibles.

El controlador puede usar el puntero de interfaz que RetrieveUsbInterface recupera para llamar a los métodos que proporciona la interfaz IWDFUsbInterface . Para obtener más información sobre el uso de estos métodos, vea Trabajar con interfaces USB en UMDF.

Ejemplos

Para obtener un ejemplo de código de cómo usar el método RetrieveUsbInterface , vea IWDFUsbTargetFactory::CreateUsbTargetDevice.

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.5
Encabezado wudfusb.h (incluya Wudfusb.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFUsbInterface

IWDFUsbTargetDevice

IWDFUsbTargetDevice::GetNumInterfaces

USBD_INTERFACE_INFORMATION