IWDFFile2::GetRelatedFileObject-Methode (wudfddi.h)

  • Artikel

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. 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 verknüpften Dateiobjekts ab, 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 der IWDFFile2-Schnittstelle verfügbar macht.

Rückgabewert

Keine

Bemerkungen

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

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

Beispiele

Im folgenden Codebeispiel wird die IWDFFile-Schnittstelle eines verknüpften Dateiobjekts von der IWDFFile-Schnittstelle abgerufen, die die IQueueCallbackCreate::OnCreateFile-Rückruffunktion eines Treibers 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
UMDF-Mindestversion 1.9
Kopfzeile wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Weitere Informationen

IWDFFile2