Método IWDFUsbTargetDevice::RetrieveUsbInterface (wudfusb.h)
[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 |
|---|---|
|
RetrieveUsbInterface recuperó correctamente la interfaz USB especificada para el dispositivo USB. |
|
RetrieveUsbInterface encontró un error de asignación. |
|
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 |