IWDFFile2::GetRelatedFileObject-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]

Die GetRelatedFileObject--Methode ruft die IWDFFile Schnittstelle eines verwandten Dateiobjektsab, bei dem es sich um ein Dateiobjekt handelt, das eine technologiespezifische Beziehung zu einem anderen Dateiobjekt aufweist.

Syntax

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

Parameter

[out] ppRelatedFileObj

Die Adresse eines Speicherorts, der einen Zeiger auf die IWDFFile Schnittstelle eines UMDF-Dateiobjekts empfängt. Dieses Dateiobjekt bezieht sich auf das Dateiobjekt, das die übergeordnete IWDFFile2- Schnittstelle IWDFFile Schnittstelle verfügbar macht.

Rückgabewert

Nichts

Bemerkungen

Die Verwendung verwandter Dateiobjekte ist technologiespezifisch. Beispielsweise verwendet Kernelstreaming verwandte Dateiobjekte, um die übergeordneten Filter untergeordneter Pins darzustellen.

Weitere Informationen zu verwandten Dateiobjekten finden Sie im GetRelatedFileObject Member der Kernelmodus-FILE_OBJECT Struktur.

Beispiele

Im folgenden Codebeispiel wird die IWDFFile- Schnittstelle eines verknüpften Dateiobjekts aus der IWDFFile- Schnittstelle abgerufen, die ein Treiber IQueueCallbackCreate::OnCreateFile Rückruffunktion empfängt.

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);
    ...

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform-	Desktop
Mindest-UMDF-Version	1.9
Header-	wudfddi.h (include Wudfddi.h)
DLL-	WUDFx.dll

Siehe auch

IWDFFile2-