Función ChangerReinitializeUnit (mcd.h)
ChangerReinitializeUnit controla los aspectos específicos del dispositivo de un IRP de control de dispositivo con el código IOCTL IOCTL_CHANGER_REINITIALIZE_TRANSPORT.
Sintaxis
NTSTATUS ChangerReinitializeUnit(
[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 recalibración de un elemento de transporte, ChangerReinitializeUnit devuelve el valor STATUS_XXX devuelto por el controlador de puerto del sistema o uno de los siguientes valores:
STATUS_SUCCESS
STATUS_INVALID_ELEMENT_ADDRESS
STATUS_INVALID_PARAMETER
STATUS_INSUFFICIENT_RESOURCES
Si el modificador no admite la recalibración de un elemento de transporte, ChangerReinitializeUnit devuelve STATUS_INVALID_DEVICE_REQUEST.
Comentarios
Esta rutina es necesaria.
ChangerReinitializeUnit hace que el modificador vuelva a almacenar su elemento de transporte. Dependiendo del cambiador, esto puede devolver el transporte a una posición "home". El controlador de clase changer normalmente llama a ChangerReinitializeUnit después de que el modificador se haya encendido o una aplicación de llamada haya iniciado una operación de recuperación. La marca CHANGER_DEVICE_REINITIALIZE_CAPABLE en Características0 de GET_CHANGER_PARAMETERS indica si el transporte del modificador admite la recalibración en esas circunstancias.
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 ChangerReinitializeUnit. Irp-SystemBuffer> apunta a una estructura de CHANGER_ELEMENT que indica el elemento que se va a volver a almacenar.
ChangerReinitializeUnit crea un SRB con un CDB para colocar el elemento de transporte y enviarlo al controlador de puerto del sistema.
ChangerReinitializeUnit establece el campo Información del bloque de estado de E/S en sizeof(CHANGER_ELEMENT) antes de volver al controlador de clase changer.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | mcd.h (incluya Mcd.h, Ntddchgr.h) |
| IRQL | PASSIVE_LEVEL |