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

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

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

Синтаксис

WINUSB_INTERFACE_HANDLE GetWinUsbHandle();

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

GetWinUsbHandle возвращает дескриптор интерфейса WinUsb, связанный с целевым объектом устройства ввода-вывода.

Замечания

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

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

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

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.5
заголовка wudfusb.h (include Wudfusb.h)
DLL WUDFx.dll

См. также

IWDFUsbTargetDevice

WinUsb_Free

WinUsb_Initialize