Метод IWDFFile2::GetRelatedFileObject (wudfddi.h)

Статья
08/08/2023

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

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

Синтаксис

void GetRelatedFileObject(
  [out] IWDFFile **ppRelatedFileObj
);

Параметры

[out] ppRelatedFileObj

Адрес расположения, которое получает указатель на интерфейс IWDFFile объекта файла UMDF. Этот объект файла связан с объектом file, который предоставляет родительский интерфейс IWDFFile2 интерфейса IWDFFile .

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

None

Remarks

Использование связанных файловых объектов зависит от технологии. Например, потоковая передача ядра использует связанные объекты файлов для представления родительских фильтров дочерних контактов.

Дополнительные сведения о связанных объектах файлов см. в разделе Элемент GetRelatedFileObject структуры FILE_OBJECT режима ядра.

Примеры

В следующем примере кода извлекается интерфейс IWDFFile связанного объекта файла из интерфейса IWDFFile , который получает функция обратного вызова IQueueCallbackCreate::OnCreateFile драйвера.

VOID
STDMETHODCALLTYPE
CMyQueue::OnCreateFile(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in IWDFFile*  pWdfFileObject
    )
 ...
    IWDFFile*  pWdfRelatedFileObject = NULL;
    IWDFFile2*  pWdfFileObject2 = NULL;
    HRESULT  hr = S_OK;

    //
    // Obtain IWDFFile2 interface from IWDFFile.
    //
    hr = pWdfFileObject->QueryInterface(IID_PPV_ARGS(&pWdfFileObject2));
    if (!SUCCEEDED(hr))
    {
        goto Done;
    }
    pWdfFileObject2->GetRelatedFileObject(&pWdfRelatedFileObject);
    ...

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1,9
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll

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

IWDFFile2

Поделиться через