Метод IWDFUsbInterface::GetWinUsbHandle (wudfusb.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод GetWinUsbHandle извлекает дескриптор интерфейса WinUsb, связанный с USB-интерфейсом.

Синтаксис

WINUSB_INTERFACE_HANDLE GetWinUsbHandle();

Возвращаемое значение

GetWinUsbHandle возвращает дескриптор интерфейса WinUsb, связанный с интерфейсом USB.

Комментарии

При вызове в интерфейсе по умолчанию метод IWDFUsbInterface::GetWinUsbHandle возвращает тот же дескриптор интерфейса WinUsb, что и IWDFUsbTargetDevice::GetWinUsbHandle. Интерфейс по умолчанию определяется нулевым индексом.

При вызове в интерфейсах с индексом больше нуля IWDFUsbInterface::GetWinUsbHandle возвращает дескриптор, отличный от IWDFUsbTargetDevice::GetWinUsbHandle.

Драйвер UMDF может использовать дескриптор интерфейса WinUsb для обхода интерфейсов UMDF и вызова подпрограмм WinUSB непосредственно для операций, связанных с интерфейсом.

Драйвер UMDF не должен вызывать функцию WinUsb_Free , чтобы освободить дескриптор интерфейса WinUsb, так как дескриптор принадлежит объекту интерфейса USB.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfusb.h (включая Wudfusb.h)
DLL WUDFx.dll

См. также раздел

IWDFUsbInterface

WinUsb_Free

WinUsb_Initialize