Método IWDFUsbInterface::GetWinUsbHandle (wudfusb.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
O método GetWinUsbHandle recupera o identificador de interface WinUsb associado a uma interface USB.
Sintaxe
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Retornar valor
GetWinUsbHandle retorna o identificador de interface WinUsb associado à interface USB.
Comentários
Se chamado na interface padrão, o método IWDFUsbInterface::GetWinUsbHandle retorna o mesmo identificador de interface WinUsb que IWDFUsbTargetDevice::GetWinUsbHandle. A interface padrão é identificada pelo índice zero.
Se chamado em interfaces com índice maior que zero, IWDFUsbInterface::GetWinUsbHandle retorna um identificador diferente de IWDFUsbTargetDevice::GetWinUsbHandle.
Um driver UMDF pode usar o identificador de interface WinUsb para ignorar as interfaces UMDF e chamar rotinas do WinUSB diretamente para operações relacionadas à interface.
O driver UMDF não deve chamar a função WinUsb_Free para liberar o identificador da interface WinUsb porque o objeto de interface USB possui o identificador.
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1.5 |
| Cabeçalho | wudfusb.h (inclua Wudfusb.h) |
| DLL | WUDFx.dll |