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

Статья
02/27/2024

[Применимо к 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 , заполняемую платформой.

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

None

Remarks

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Дополнительные сведения о методе WdfUsbInterfaceGetEndpointInformation и целевых объектах USB-ввода-вывода см. в статье Usb I/O Targets.

Примеры

В следующем примере кода показано, как получить количество конечных точек, поддерживаемых интерфейсом 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 (включая 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

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