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 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
Aucun
Remarques
Avant d’utiliser IoSetDeviceToVerify et IoVerifyVolume, les enregistreurs 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 du support multimédia amovible.
IoSetDeviceToVerify est appelée pour indiquer qu’un objet d’appareil donné, représentant un appareil multimédia 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 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’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) |