Функция 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) |