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