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
| 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) |