Fonction IoSetDeviceToVerify (ntifs.h)

  • Article

La routine IoSetDeviceToVerify définit l’objet d’appareil à vérifier dans le thread spécifié. L’objet d’appareil spécifié représente un périphérique multimédia amovible.

Syntaxe

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

Paramètres

[in] Thread

Pointeur vers une structure d’objet thread ETHREAD pour le thread.

[in, optional] DeviceObject

Pointeur vers une structure de DEVICE_OBJECT qui identifie l’objet d’appareil pour un périphérique multimédia amovible. DeviceObject peut avoir la valeur NULL.

Valeur de retour

None

Remarques

Avant d’utiliser IoSetDeviceToVerify et IoVerifyVolume, les rédacteurs de pilotes doivent étudier la façon dont ces routines sont utilisées dans l’exemple FASTFAT. Pour plus d’informations, consultez également Prise en charge des supports amovibles.

IoSetDeviceToVerify est appelé pour indiquer qu’un objet d’appareil donné, représentant un appareil amovible, doit être vérifié. Appelez IoGetDeviceToVerify pour obtenir l’objet d’appareil qui est la cible de la demande d’E/S du thread donné.

Un pilote de système de fichiers doit vérifier un volume lorsqu’il reçoit une notification d’un pilote de périphérique amovible sous-jacent indiquant que le média semble avoir changé depuis le dernier accès à l’appareil cible. Le système de fichiers appelle généralement IoSetDeviceToVerify et IoVerifyVolume lorsque l’appareil inférieur retourne STATUS_VERIFY_REQUIRED.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI IrqlIoDispatch(wdm)

Voir aussi

IRP

IoGetDeviceToVerify

IoVerifyVolume

PsGetCurrentThread