IoGetDeviceToVerify-Funktion (ntifs.h)

Die IoGetDeviceToVerify-Routine gibt einen Zeiger auf das Geräteobjekt zurück, der ein Wechselmediengerät darstellt, das das Ziel der E/A-Anforderung des angegebenen Threads ist.

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 obersten Ebene versucht, die Gültigkeit der Medien zu überprüfen, auf denen 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.

Hinweise

Im Allgemeinen werden Treiber der höchsten Ebene, insbesondere Dateisysteme, diese Routine am ehesten aufrufen.

Ein zugrunde liegender Wechselmediengerätetreiber ist für die Benachrichtigung von Treibern höherer Ebene, insbesondere des Dateisystems, verantwortlich, wenn sich die Medien seit dem letzten Zugriff auf das Zielgerät anscheinend geändert haben. Weitere Informationen finden Sie unter Benachrichtigen des Dateisystems über mögliche Medienänderungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)

Weitere Informationen

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread