WdfIoTargetWdmGetFileObject-Funktion (wdfiotarget.h)

[Gilt nur für KMDF]

Die WdfIoTargetWdmGetTargetFileObject-Methode gibt einen Zeiger auf das WdM-Dateiobjekt (Windows Driver Model) zurück, das einem angegebenen Remote-E/A-Ziel zugeordnet ist.

Syntax

PFILE_OBJECT WdfIoTargetWdmGetTargetFileObject(
  [in] WDFIOTARGET IoTarget
);

Die Parameter

[in] IoTarget

Ein Handle für ein Remote-E/A-Zielobjekt. Dieses Handle wurde aus einem vorherigen Aufruf von WdfIoTargetCreateabgerufen.

Rückgabewert

WdfIoTargetWdmGetTargetFileObject gibt einen Zeiger auf eine WDM-FILE_OBJECT-Struktur zurück.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Der Zeiger, den die WdfIoTargetWdmGetFileObject-Methode zurückgibt, ist gültig, bis der Treiber WdfIoTargetClose oder WdfIoTargetCloseForQueryRemoveoder bis das Remote-E/A-Zielobjekt gelöscht wird. Wenn der Treiber eine EvtCleanupCallback--Funktion für das Remote-E/A-Zielobjekt bereitstellt und das Objekt gelöscht wird, bevor das Remote-E/A-Ziel geschlossen wird, ist der Zeiger gültig, bis die EvtCleanupCallback--Funktion zurückgegeben wird.

Wenn der Treiber versucht, nach dem Entfernen auf das WDM-Geräteobjekt zuzugreifen, kann der Treiber dazu führen, dass das System abstürzt. Im Beispiel wird veranschaulicht, wie der Treiber eine EvtIoTargetQueryRemove Rückruffunktion bereitstellen kann, damit sie benachrichtigt wird, wenn das E/A-Ziel entfernt wird.

Weitere Informationen zu WdfIoTargetWdmGetTargetFileObjectfinden Sie unter Abrufen von Informationen zu einem allgemeinen E/A-Ziel-.

Weitere Informationen zu E/A-Zielen finden Sie unter Using I/O Targets.

Beispiele

Das folgende Codebeispiel ruft einen Zeiger auf das WDM-Dateiobjekt ab, das einem Remote-E/A-Ziel zugeordnet ist.

PFILE_OBJECT pfileObject;

pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);

Anforderungen

Siehe auch

FILE_OBJECT

WdfIoTargetCreate

WdfIoTargetWdmGetTargetDeviceObject

WdfIoTargetWdmGetTargetFileHandle