Función ChangerMoveMedium (mcd.h)

Artículo
02/29/2024

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

Sintaxis

NTSTATUS ChangerMoveMedium(
  [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

ChangerMoveMedium devuelve el estado devuelto por el controlador de puerto del sistema o uno de los valores siguientes:

STATUS_SUCCESS

STATUS_DESTINATION_ELEMENT_FULL

STATUS_INVALID_ELEMENT_ADDRESS

STATUS_INVALID_DEVICE_REQUEST

STATUS_INVALID_PARAMETER

STATUS_INSUFFICIENT_RESOURCES

STATUS_SOURCE_ELEMENT_EMPTY

Comentarios

Esta rutina es necesaria.

ChangerMoveMedium mueve un elemento multimedia de un elemento a otro.

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 ChangerMoveMedium. Irp-SystemBuffer>apunta a una estructura de CHANGER_MOVE_MEDIUM que indica el elemento de transporte, el origen, el destino y si se va a voltear el medio.

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

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