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 接口的文件对象相关。

返回值

备注

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

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

示例

下面的代码示例从驱动程序 的 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