Метод 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 |