共用方式為

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
標頭 wudfddi.h （包括 Wudfddi.h）
DLL WUDFx.dll

另請參閱

IWDFFile

IWDFIoRequest