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 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 |