Partager via


Fonction IoGetDeviceToVerify (ntifs.h)

La routine IoGetDeviceToVerify retourne un pointeur vers l’objet de l’appareil, représentant un appareil multimédia amovible, qui est la cible de la requête d’E/S du thread donné.

Syntaxe

PDEVICE_OBJECT IoGetDeviceToVerify(
  [in] PETHREAD Thread
);

Paramètres

[in] Thread

Pointeur vers une structure ETHREAD dont l’objet d’appareil est interrogé. Autrement dit, thread est le thread pour lequel un pilote de niveau supérieur tente de vérifier la validité du média sur lequel le thread a ouvert un fichier.

Valeur de retour

IoGetDeviceToVerify retourne un pointeur vers une structure DEVICE_OBJECT qui identifie l’objet d’appareil représentant un appareil sur lequel le média doit être vérifié. Cette fonction peut retourner NULL.

Remarques

En général, les pilotes de niveau supérieur, en particulier les systèmes de fichiers, sont les plus susceptibles d’appeler cette routine.

Un pilote de périphérique amovible-média sous-jacent est chargé de notifier les pilotes de niveau supérieur, en particulier le système de fichiers, lorsque le média semble avoir changé depuis le dernier accès à l’appareil cible. Pour plus d’informations, consultez Notification du système de fichiers des modifications possibles des médias.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000
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 HwStorPortProhibitedDDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)

Voir aussi

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

psGetCurrentThread