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 |