Функция WdfUsbInterfaceGetEndpointInformation (wdfusb.h)

Статья
02/07/2025

[Применимо к 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)

См. также

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetNumEndpoints

WdfUsbTargetDeviceGetInterface

Поделиться через