Функция WdfUsbInterfaceGetEndpointInformation (wdfusb.h)
[Применимо к KMDF и UMDF]
Метод WdfUsbInterfaceGetEndpointInformation извлекает сведения о указанной конечной точке USB-устройства и связанном канале.
Синтаксис
void WdfUsbInterfaceGetEndpointInformation(
[in] WDFUSBINTERFACE UsbInterface,
[in] UCHAR SettingIndex,
[in] UCHAR EndpointIndex,
[in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);
Параметры
[in] UsbInterface
Дескриптор объекта USB-интерфейса, полученный путем вызова WdfUsbTargetDeviceGetInterface.
[in] SettingIndex
Значение индекса, определяющее альтернативный параметр интерфейса. Дополнительные сведения о альтернативных параметрах см. в спецификации USB.
[in] EndpointIndex
Значение индекса, определяющее конечную точку, связанную с указанным альтернативным параметром указанного интерфейса. (Это значение индекса не является адресом конечной точки.)
[in, out] EndpointInfo
Указатель на структуру, выделенную вызывающим объектом, WDF_USB_PIPE_INFORMATION, в которую заполняется платформа.
Возвращаемое значение
Никакой
Замечания
Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Дополнительные сведения о методе WdfUsbInterfaceGetEndpointInformation и целевых объектах ввода-вывода USB см. в разделе целевых объектов USB-ввода-вывода.
Примеры
Следующий пример кода получает количество конечных точек, поддерживаемых USB-интерфейсом, а затем вызывает WdfUsbInterfaceGetEndpointInformation для каждой конечной точки.
WDF_USB_PIPE_INFORMATION endPointInfo;
BYTE settingIndex, i;
settingIndex = 0;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
UsbInterface,
settingIndex
);
for (i = 0; i < numEndpoints; i++){
WDF_USB_PIPE_INFORMATION_INIT(&endPointInfo);
WdfUsbInterfaceGetEndpointInformation(
UsbInterface,
settingIndex,
i,
&endPointInfo
);
//
// Examine endpoint information here.
//
...
}
Требования
Требование | Ценность |
---|---|
целевая платформа | Всеобщий |
минимальная версия KMDF | 1.0 |
минимальная версия UMDF | 2.0 |
заголовка | wdfusb.h (include Wdfusb.h) |
библиотеки | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
правил соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |