Función ChangerSetPosition (mcd.h)

Artículo
08/07/2023

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

Sintaxis

NTSTATUS ChangerSetPosition(
  [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 de la posición del elemento de transporte, ChangerSetPosition devuelve el estado devuelto por el controlador de puerto del sistema o uno de los valores siguientes:

STATUS_SUCCESS

STATUS_INFO_LENGTH_MISMATCH

STATUS_INVALID_PARAMETER

STATUS_INSUFFICIENT_RESOURCES

Si el modificador no admite establecer la posición del elemento de transporte, ChangerSetPosition devuelve STATUS_INVALID_DEVICE_REQUEST.

Comentarios

Esta rutina es necesaria.

ChangerSetPosition establece el mecanismo de transporte robotizado del modificador en el destino especificado, normalmente para optimizar el movimiento o el intercambio de medios colocando primero el transporte.

La marca CHANGER_POSITION_TO_ELEMENT en Características0 de GET_CHANGER_PARAMETERS indica si el modificador admite esta funcionalidad.

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

ChangerSetPosition comprueba primero que las direcciones del elemento de transporte y destino son válidas y convierte las direcciones de elementos de base cero en direcciones específicas del dispositivo. A continuación, compila una SRB con un CDB para colocar el elemento y enviarlo al controlador de puerto del sistema.

ChangerSetPosition establece el campo Información del bloque de estado de E/S en sizeof(CHANGER_SET_POSITION) antes de volver al controlador de clase del modificador.