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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren 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 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
Keine
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 ausstehen. Das Framework benachrichtigt den Treiber als Reaktion auf eine Anwendung, die 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 | Windows |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |