Partager via


Fonction IoGetDeviceToVerify (ntifs.h)

La routine IoGetDeviceToVerify retourne un pointeur vers l’objet d’appareil, représentant un appareil de média amovible, qui est la cible de la demande 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 retournée

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 de support amovible 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 au système de fichiers des modifications possibles du média.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000
Plateforme cible Universal
En-tête ntifs.h (inclure 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