Método IWDFUsbInterface::GetWinUsbHandle (wudfusb.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante 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 a 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.
Observaciones
Si se llama en la interfaz predeterminada, el método IWDFUsbInterface::GetWinUsbHandle devuelve el mismo identificador de interfaz winUsb que IWDFUsbTargetDevice::GetWinUsbHandle. La interfaz predeterminada se identifica mediante el índice cero.
Si se llama a en interfaces con índice mayor que cero, IWDFUsbInterface::GetWinUsbHandle devuelve un identificador diferente que IWDFUsbTargetDevice::GetWinUsbHandle.
Un controlador UMDF puede usar el controlador de interfaz WinUsb para omitir las interfaces umDF y llamar a rutinas 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 | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfusb.h (incluya Wudfusb.h) |
| DLL de | WUDFx.dll |