IWDFIoRequest::GetFileObject 方法 (wudfddi.h)

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

GetFileObject 方法检索指向与 I/O 请求关联的 IWDFFile 接口的指针。

语法

void GetFileObject(
  [out] IWDFFile **ppFileObject
);

参数

[out] ppFileObject

指向缓冲区的指针,用于接收指向文件对象的 IWDFFile 接口的指针。 请注意,返回 NULL 有效。

返回值

备注

驱动程序调用 GetFileObject 时,框架会递增接口上的引用计数。 驱动程序负责在接口指针完成后释放引用。 为此,可以使用智能指针在对象退出上下文时自动递减引用计数,或者在完成该指针时调用接口上的 Release

示例

以下代码示例摘自 WDK 中的 WpdMultiTransportDriver 示例。 该示例声明指向 IWDFFile 接口的智能指针,调用 GetFileObject,然后在文件对象上调用 RetrieveContext

  CComPtr<IWDFFile>   pFileObject;

  ...

  // Get the Context map for this client

  pRequest->GetFileObject(&pFileObject);

  if (pFileObject != NULL)
  {
      hr = pFileObject->RetrieveContext((void**)&pClientContextMap);
      CHECK_HR(hr, "Failed to get Contextmap from WDF File Object");
  }
  

要求

   
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.5
Header wudfddi.h (包括 Wudfddi.h)
DLL WUDFx.dll

另请参阅

IWDFFile

IWDFIoRequest