Método IWDFUsbInterface::GetWinUsbHandle (wudfusb.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo 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 aoda UMDF .]
O método GetWinUsbHandle recupera o identificador de interface WinUsb associado a uma interface USB.
Sintaxe
WINUSB_INTERFACE_HANDLE GetWinUsbHandle();
Valor de retorno
GetWinUsbHandle retorna o identificador de interface WinUsb associado à interface USB.
Observações
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 uma alça 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. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.5 |
| cabeçalho | wudfusb.h (inclua Wudfusb.h) |
| de DLL | WUDFx.dll |