Freigeben über


IFileCallbackCleanup::OnCleanupFile-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 OnCleanupFile- Methode bricht alle E/A-Anforderungen ab, die ein Treiber in der Frameworkwarteschlange aussteht.

Syntax

void OnCleanupFile(
  [in] IWDFFile *pWdfFileObject
);

Parameter

[in] pWdfFileObject

Ein Zeiger auf die IWDFFile Schnittstelle für das Dateiobjekt, das dem Gerät zugeordnet ist.

Rückgabewert

Nichts

Bemerkungen

Ein Treiber registriert die IFileCallbackCleanup Schnittstelle, wenn der Treiber die IWDFDriver::CreateDevice Methode aufruft, um ein Geräteobjekt zu erstellen.

Das Framework ruft die OnCleanupFile--Methode auf, um den Treiber zu benachrichtigen, alle E/A-Anforderungen abzubrechen, die ausstehend sind. Das Framework benachrichtigt den Treiber als Reaktion auf eine Anwendung, die microsoft Win32 CloseHandle-Funktion aufruft.

Informationen dazu, wann das Framework OnCleanupFile-aufruft, finden Sie unter Driver-Created Versus Application-Created File Objects.

Anforderungen

Anforderung Wert
Zielplattform- Fenster
Header- wudfddi.h (include Wudfddi.h)

Siehe auch

IFileCallbackCleanup

IWDFDriver::CreateDevice

IWDFFile-