Función ChangerGetParameters (mcd.h)
ChangerGetParameters controla los aspectos específicos del dispositivo de un IRP de control de dispositivo con el código IOCTL IOCTL_CHANGER_GET_PARAMETERS.
Sintaxis
NTSTATUS ChangerGetParameters(
[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
ChangerGetParameters devuelve el valor STATUS_XXX devuelto por el controlador de puerto del sistema o uno de los siguientes valores:
STATUS_SUCCESS
STATUS_INFO_LENGTH_MISMATCH
STATUS_INSUFFICIENT_RESOURCES
Comentarios
Esta rutina es necesaria.
ChangerGetParameters devuelve los parámetros de un modificador, incluido el número y el tipo de sus elementos y la funcionalidad que admite.
El controlador de clase changer comprueba la longitud del búfer de salida en la ubicación de la pila de E/S antes de llamar a ChangerGetParameters. Si la longitud del búfer de salida es menor que sizeof(GET_CHANGER_PARAMETERS), el controlador de clase modificador devuelve con un valor de STATUS_INFO_LENGTH_MISMATCH.
ChangerGetParameters recupera datos de parámetros del dispositivo mediante la compilación de SRB con CDB para obtener la página de encabezado del parámetro SCSI, la página de direcciones del elemento, la página de geometría de transporte y la página de funcionalidades del dispositivo, o el equivalente no SCSI de estos datos.
ChangerGetParameters rellena entonces una estructura de GET_CHANGER_PARAMETERS en Irp-AssociatedIrp.SystemBuffer> 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 |