共用方式為

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 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