IWDFFile2：：GetRelatedFileObject 方法 (wudfddi.h)

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 #DA94C9D71657A42E8BB9B1274E76E8FE2 上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]

GetRelatedFileObject 方法會擷取相關檔案物件的IWDFFile 介面，這是與另一個檔案物件具有技術特定關聯性的檔案物件。

語法

void GetRelatedFileObject(
  [out] IWDFFile **ppRelatedFileObj
);

參數

[out] ppRelatedFileObj

接收 UMDF 檔案物件之 IWDFFile 介面指標的位置位址。 這個檔案對象與公開 IWDFFile2 介面父 IWDFFile 介面的檔案對象有關。

傳回值

無

備註

使用相關的檔案對像是技術特定的。 例如， 核心串流 會使用相關的檔案物件來代表子釘選的父篩選。

如需相關檔案對象的詳細資訊，請參閱 kernel-mode 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);
    ...

規格需求

另請參閱

IWDFFile2