ChangerSetAccess, fonction (mcd.h)

Article
02/29/2024

ChangerSetAccess gère les aspects spécifiques à l’appareil d’un IRP de contrôle d’appareil avec le code IOCTL IOCTL_CHANGER_SET_ACCESS.

Syntaxe

NTSTATUS ChangerSetAccess(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

Paramètres

[in] DeviceObject

Pointeur vers l’objet d’appareil qui représente le changeur.

[in] Irp

Pointeur vers l’IRP.

Valeur retournée

Si le changeur prend en charge la définition de l’accès, ChangerSetAccess renvoie la valeur STATUS_XXX retournée par le pilote de port système ou l’une des valeurs suivantes :

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

Si le changeur ne prend pas en charge l’accès aux paramètres, ChangerSetAccess retourne STATUS_INVALID_DEVICE_REQUEST.

Remarques

Cette routine est obligatoire.

ChangerSetAccess verrouille ou déverrouille l’IEport, la porte ou le clavier d’un changeur, et étend ou retire un IEport.

Le pilote de classe de changeur vérifie la longueur de la mémoire tampon d’entrée dans l’emplacement de la pile d’E/S avant d’appeler ChangerSetAccess. Irp-SystemBuffer> pointe vers une structure CHANGER_SET_ACCESS en tant que paramètre d’entrée qui indique l’élément à définir et l’opération à effectuer.

ChangerSetAccess recherche d’abord les éléments et les opérations non pris en charge, puis retourne le code status approprié pour ceux qu’il ne prend pas en charge.

Ensuite, ChangerSetAccess traduit l’adresse d’élément de base zéro passée par le système en l’adresse d’élément spécifique à l’appareil requise par le changeur.

Enfin, ChangerSetAccess génère un SRB avec une CDB pour l’opération donnée sur l’élément donné et l’envoie au pilote de port système. La commande à utiliser dépend du changeur. Par exemple, le pilote de miniclasse Exabyte utilise la commande SCSI PREVENT ALLOW MEDIUM REMOVAL pour verrouiller ou déverrouiller une porte de changeur et MOVE MEDIUM pour étendre ou retirer un IEport.