IWDFIoRequest：：GetFileObject 方法 (wudfddi.h)

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #DF0AC8E7A9D724D1CA0DE7F5B3FAC9BD0 上，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