Método IWDFUsbInterface::GetWinUsbHandle (wudfusb.h)

  • Artigo

[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

Confira também

IWDFUsbInterface

WinUsb_Free

WinUsb_Initialize