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

Статья
08/08/2023

[Относится только к KMDF]

Метод WdfIoTargetWdmGetTargetDeviceObject возвращает указатель на объект устройства модели драйвера Windows (WDM), связанный с указанным локальным или удаленным целевым объектом ввода-вывода.

Синтаксис

PDEVICE_OBJECT WdfIoTargetWdmGetTargetDeviceObject(
  [in] WDFIOTARGET IoTarget
);

Параметры

[in] IoTarget

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

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

WdfIoTargetWdmGetTargetDeviceObject возвращает указатель на структуру DEVICE_OBJECT WDM.

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

Указатель, возвращаемый методом WdfIoTargetWdmGetTargetDeviceObject , действителен до тех пор, пока драйвер не вызовет WdfIoTargetClose или WdfIoTargetCloseForQueryRemove или пока не будет удален удаленный целевой объект ввода-вывода. Если драйвер предоставляет функцию EvtCleanupCallback для удаленного целевого объекта ввода-вывода и если объект удаляется до закрытия удаленного целевого объекта ввода-вывода, указатель будет действителен до тех пор, пока функция EvtCleanupCallback не вернется.

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

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

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

Примеры

В следующем примере кода проверяется структура WDM-DEVICE_OBJECT целевого объекта ввода-вывода, чтобы убедиться, что целевой объект поддерживает прямые операции ввода-вывода.

if (!((WdfIoTargetWdmGetTargetDeviceObject(Adapter->IoTarget))->Flags
 & DO_DIRECT_IO)) {
    ASSERTMSG("Target device doesn't support direct I/O\n", FALSE);
    return STATUS_INVALID_DEVICE_REQUEST;
}

Требования

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