IoSetDeviceToVerify-Funktion (ntifs.h)

  • Artikel

Die IoSetDeviceToVerify-Routine legt das Geräteobjekt fest, das im angegebenen Thread überprüft werden soll. Das angegebene Geräteobjekt stellt ein Wechselmedium dar.

Syntax

void IoSetDeviceToVerify(
  [in]           PETHREAD       Thread,
  [in, optional] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] Thread

Zeiger auf eine ETHREAD-Threadobjektstruktur für den Thread.

[in, optional] DeviceObject

Zeiger auf eine DEVICE_OBJECT-Struktur , die das Geräteobjekt für ein Wechselmediengerät identifiziert. DeviceObject kann NULL sein.

Rückgabewert

Keine

Bemerkungen

Vor der Verwendung von IoSetDeviceToVerify und IoVerifyVolume sollten Treiberautoren untersuchen, wie diese Routinen im FASTFAT-Beispiel verwendet werden. Weitere Informationen finden Sie unter Unterstützung von Wechselmedien.

IoSetDeviceToVerify wird aufgerufen, um anzugeben, dass ein bestimmtes Geräteobjekt, das ein Wechselmedium darstellt, überprüft werden muss. Rufen Sie IoGetDeviceToVerify auf, um das Geräteobjekt abzurufen, das das Ziel der E/A-Anforderung des angegebenen Threads ist.

Ein Dateisystemtreiber muss ein Volume überprüfen, wenn es eine Benachrichtigung von einem zugrunde liegenden Wechselmediengerätetreiber empfängt, dass sich die Medien seit dem letzten Zugriff auf das Zielgerät anscheinend geändert haben. Das Dateisystem ruft in der Regel IoSetDeviceToVerify und IoVerifyVolume auf , wenn das untere Gerät STATUS_VERIFY_REQUIRED zurückgibt.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header ntifs.h (include Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln IrqlIoDispatch(wdm)

Weitere Informationen

IRP

IoGetDeviceToVerify

IoVerifyVolume

PsGetCurrentThread