Función ChangerSetAccess (mcd.h)

Artículo
02/29/2024

ChangerSetAccess controla los aspectos específicos del dispositivo de un IRP de control de dispositivo con el código IOCTL IOCTL_CHANGER_SET_ACCESS.

Sintaxis

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

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo que representa el modificador.

[in] Irp

Puntero al IRP.

Valor devuelto

Si el modificador admite la configuración del acceso, ChangerSetAccess devuelve el valor STATUS_XXX devuelto por el controlador de puerto del sistema o uno de los siguientes valores:

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

Si el modificador no admite la configuración del acceso, ChangerSetAccess devuelve STATUS_INVALID_DEVICE_REQUEST.

Comentarios

Esta rutina es necesaria.

ChangerSetAccess bloquea o desbloquea el IEport, la puerta o el teclado de un cambiador, y extiende o retira un IEport.

El controlador de clase changer comprueba la longitud del búfer de entrada en la ubicación de la pila de E/S antes de llamar a ChangerSetAccess. Irp-SystemBuffer> apunta a una estructura de CHANGER_SET_ACCESS como parámetro de entrada que indica el elemento que se va a establecer y la operación que se va a realizar.

ChangerSetAccess comprueba primero si hay elementos y operaciones no admitidos, y devuelve el código de estado adecuado para aquellos que no admite.

A continuación, ChangerSetAccess traduce la dirección del elemento de base cero pasada por el sistema a la dirección de elemento específica del dispositivo requerida por el modificador.

Por último, ChangerSetAccess compila un SRB con un CDB para la operación especificada en el elemento especificado y lo envía al controlador de puerto del sistema. El comando que se va a usar depende del modificador. Por ejemplo, el controlador de miniclase Exabyte usa el comando SCSI PREVENT ALLOW MEDIUM REMOVAL para bloquear o desbloquear una puerta de cambio y MOVE MEDIUM para extender o retirar un IEport.