Функция WdfIoTargetGetDevice (wdfiotarget.h)

  • Статья

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

Метод WdfIoTargetGetDevice возвращает дескриптор объекту устройства платформы, который является родительским объектом указанного локального или удаленного целевого объекта ввода-вывода.

Синтаксис

WDFDEVICE WdfIoTargetGetDevice(
  [in] WDFIOTARGET IoTarget
);

Параметры

[in] IoTarget

Дескриптор целевого объекта ввода-вывода. Этот дескриптор получается из WdfDeviceGetIoTarget, WdfIoTargetCreate или из метода, который предоставляет специализированный целевой объект ввода-вывода (например , WdfUsbTargetDeviceGetIoTarget).

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

WdfIoTargetGetDevice возвращает дескриптор объекту устройства платформы.

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

Комментарии

Дополнительные сведения о WdfIoTargetGetDevice см. в разделе Получение сведений об общем целевом объекте ввода-вывода.

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

Примеры

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

NTSTATUS
MyEvtIoTargetQueryRemove(
    WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfiotarget.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WdfDeviceGetIoTarget

WdfIoTargetCreate

WdfUsbTargetDeviceGetIoTarget