Fonction IoSetDeviceToVerify (ntifs.h)

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

Voir aussi

IRP

IoGetDeviceToVerify

IoVerifyVolume

PsGetCurrentThread