IWDFFile2：：GetRelatedFileObject 方法（wudfddi.h）

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1，并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅 UMDF入门 。]

GetRelatedFileObject 方法检索 相关文件对象的 IWDFFile 接口，该接口是与另一个文件对象具有技术特定的关系的文件对象。

语法

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

参数

[out] ppRelatedFileObj

接收指向 UMDF 文件对象的 IWDFFile 接口的位置的地址。 此文件对象与公开 IWDFFile2 接口的父 IWDFFile 接口的文件对象相关。

返回值

没有

言论

使用相关文件对象特定于技术。 例如，内核流式处理 使用相关的文件对象来表示子引脚的父筛选器。

有关相关文件对象的详细信息，请参阅 GetRelatedFileObject 内核模式 FILE_OBJECT 结构的成员。

例子

下面的代码示例从驱动程序 IQueueCallbackCreate：：OnCreateFile 回调函数接收的 IWDFFile 接口检索相关文件对象的 IWDFFile 接口。

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