Функция 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 после его удаления, драйвер может вызвать сбой системы. В примере toastmon показано, как драйвер может предоставить функцию обратного вызова EvtIoTargetQueryRemove, чтобы она была уведомлена об удалении целевого объекта ввода-вывода.

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

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

Примеры

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

PFILE_OBJECT pfileObject;

pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);

Требования

См. также

FILE_OBJECT

WdfIoTargetCreate

WdfIoTargetWdmGetTargetDeviceObject

WdfIoTargetWdmGetTargetFileHandle