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

Статья
02/07/2025

[ предупреждение: 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. Этот объект файла связан с объектом файла, который предоставляет родительский интерфейс IWDFFile2 интерфейса IWDFFile 2 интерфейсе IWDFFile.

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

Никакой

Замечания

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

Дополнительные сведения о связанных объектах файлов см. в разделе 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 (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFFile2

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