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

  • Статья

[Относится к KMDF и UMDF]

Метод WdfUsbTargetPipeGetIoTarget возвращает дескриптор целевому объекту ввода-вывода, связанному с указанным USB-каналом.

Синтаксис

WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
  [in] WDFUSBPIPE Pipe
);

Параметры

[in] Pipe

Дескриптор объекта канала платформы, полученный путем вызова WdfUsbInterfaceGetConfiguredPipe.

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

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

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

Комментарии

Дополнительные сведения о методе WdfUsbTargetPipeGetIoTarget и целевых объектах ввода-вывода USB см. в разделе Целевые объекты ввода-вывода USB.

Примеры

В следующем примере кода показано, как функция обратного вызова EvtDeviceD0Entry может запустить непрерывное средство чтения для USB-канала.

NTSTATUS
MyEvtDeviceD0Entry(
    IN  WDFDEVICE Device,
    IN  WDF_POWER_DEVICE_STATE PreviousState
)
{
    PDEVICE_CONTEXT  pDeviceContext;
    NTSTATUS  status;

    pDeviceContext = GetMyDeviceContext(Device);

    status = WdfIoTargetStart(WdfUsbTargetPipeGetIoTarget(pDeviceContext->InterruptPipe));

    return status;
}

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfusb.h (включая Wdfusb.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Любой уровень
Правила соответствия DDI DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf)

См. также раздел

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceGetIoTarget