Método IWDFUsbInterface::GetWinUsbHandle (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 GetWinUsbHandle recupera el identificador de interfaz WinUsb asociado a una interfaz USB.

Sintaxis

WINUSB_INTERFACE_HANDLE GetWinUsbHandle();

Valor devuelto

GetWinUsbHandle devuelve el identificador de interfaz WinUsb asociado a la interfaz USB.

Comentarios

Si se llama a en la interfaz predeterminada, el método IWDFUsbInterface::GetWinUsbHandle devuelve el mismo identificador de interfaz winUsb que IWDFUsbTargetDevice::GetWinUsbHandle. La interfaz predeterminada se identifica por el índice cero.

Si se llama a en interfaces con un índice mayor que cero, IWDFUsbInterface::GetWinUsbHandle devuelve un identificador diferente al de IWDFUsbTargetDevice::GetWinUsbHandle.

Un controlador UMDF puede usar el identificador de interfaz WinUsb para omitir las interfaces UMDF y llamar a rutinas de WinUSB directamente para las operaciones relacionadas con la interfaz.

El controlador UMDF no debe llamar a la función WinUsb_Free para liberar el identificador de la interfaz WinUsb porque el objeto de interfaz USB posee el identificador.

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

WinUsb_Free

WinUsb_Initialize