Freigeben über


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)

Siehe auch

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread-