Функция WdfIoTargetWdmGetTargetFileObject (wdfiotarget.h)
[Относится только к KMDF]
Метод WdfIoTargetWdmGetTargetFileObject возвращает указатель на объект файла модели драйвера Windows (WDM), связанный с указанным удаленным целевым объектом ввода-вывода.
Синтаксис
PFILE_OBJECT WdfIoTargetWdmGetTargetFileObject(
[in] WDFIOTARGET IoTarget
);
Параметры
[in] IoTarget
Дескриптор удаленного целевого объекта ввода-вывода. Этот дескриптор был получен из предыдущего вызова WdfIoTargetCreate.
Возвращаемое значение
WdfIoTargetWdmGetTargetFileObject возвращает указатель на структуру WDM FILE_OBJECT .
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Указатель, возвращаемый методом WdfIoTargetWdmGetTargetFileObject , действителен до тех пор, пока драйвер не вызовет WdfIoTargetClose или WdfIoTargetCloseForQueryRemove или пока не будет удален удаленный целевой объект ввода-вывода. Если драйвер предоставляет функцию EvtCleanupCallback для удаленного целевого объекта ввода-вывода и если объект удаляется до закрытия удаленного целевого объекта ввода-вывода, указатель будет действителен до тех пор, пока функция EvtCleanupCallback не вернется.
Если драйвер пытается получить доступ к объекту устройства WDM после его удаления, драйвер может вызвать сбой системы. В примере всплывающего уведомления показано, как драйвер может предоставить функцию обратного вызова EvtIoTargetQueryRemove , чтобы получать уведомления об удалении целевого объекта ввода-вывода.
Дополнительные сведения о WdfIoTargetWdmGetTargetFileObject см. в разделе Получение сведений об общем целевом объекте ввода-вывода.
Дополнительные сведения о целевых объектах ввода-вывода см. в разделе Использование целевых объектов ввода-вывода.
Примеры
В следующем примере кода показано, как получить указатель на объект файла WDM, связанный с удаленным целевым объектом ввода-вывода.
PFILE_OBJECT pfileObject;
pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfiotarget.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы). |
| IRQL | <=DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |