IoGetDeviceToVerify-Funktion (ntifs.h)
Die IoGetDeviceToVerify Routine gibt einen Zeiger auf das Geräteobjekt zurück, das ein Wechselmediengerät darstellt, d. h. das Ziel der E/A-Anforderung des angegebenen Threads.
Syntax
PDEVICE_OBJECT IoGetDeviceToVerify(
[in] PETHREAD Thread
);
Parameter
[in] Thread
Zeiger auf eine ETHREAD Struktur, deren Geräteobjekt abgefragt wird. Das heißt, Thread- ist der Thread, für den ein Treiber der höchsten Ebene versucht, die Gültigkeit des Mediums zu überprüfen, auf dem der Thread eine Datei geöffnet hat.
Rückgabewert
IoGetDeviceToVerify gibt einen Zeiger auf eine DEVICE_OBJECT Struktur zurück, die das Geräteobjekt identifiziert, das ein Gerät darstellt, auf dem die Medien überprüft werden sollen. Diese Funktion kann NULL zurückgeben.
Bemerkungen
In der Regel werden Treiber auf höchster Ebene, insbesondere Dateisysteme, diese Routine am ehesten aufrufen.
Ein zugrunde liegender Wechselmedientreiber ist verantwortlich für die Benachrichtigung von Treibern höherer Ebene, insbesondere des Dateisystems, wenn sich die Medien seit dem letzten Zugriff auf das Zielgerät geändert haben. Weitere Informationen finden Sie unter Benachrichtigen des Dateisystems über mögliche Medienänderungen.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000 |
Zielplattform- | Universal |
Header- | ntifs.h (einschließlich Ntifs.h) |
Library | NtosKrnl.lib |
DLL- | NtosKrnl.exe |
IRQL- | <= DISPATCH_LEVEL |
DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm) |