Compartir a través de

estructura SRB_IO_CONTROL (ntddscsi.h)

  • Artículo
Nota Los modelos del controlador de puerto SCSI y del controlador de miniporte SCSI pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar el controlador Storport y los modelos de controlador de miniport storport .
 

Sintaxis

typedef struct _SRB_IO_CONTROL {
  ULONG HeaderLength;
  UCHAR Signature[8];
  ULONG Timeout;
  ULONG ControlCode;
  ULONG ReturnCode;
  ULONG Length;
} SRB_IO_CONTROL, *PSRB_IO_CONTROL;

Miembros

HeaderLength

Es sizeof(SRB_IO_CONTROL).

Signature[8]

Identifica el HBA de destino dedicado a la aplicación para esta solicitud. Esta firma se usa para evitar conflictos en los valores de ControlCode entre proveedores. Debe ser una cadena de caracteres ASCII. Si un controlador de minipuerto no reconoce el valor de firma de entrada, debe completar la solicitud con un estado de SRB_STATUS_INVALID_REQUEST.

Timeout

Indica el intervalo en segundos que la solicitud puede ejecutarse antes de que el controlador de puerto específico del sistema operativo considere que agota el tiempo de espera. Los controladores de minipuerto deben exigir tiempos de espera para SRB_IO_CONTROL, especialmente para cualquier SRB_IO_CONTROL definido de forma privada.

ControlCode

Indica la operación que se va a realizar. No hay operaciones definidas por el sistema. El controlador debe definir los valores como un conjunto de códigos de control de E/S privados con los que la aplicación puede realizar solicitudes llamando a la función DeviceIoControl de Win32. Para obtener más información sobre cómo definir códigos de control de E/S privados para las solicitudes de control de dispositivos, consulte Uso de códigos de control de E/S.

ReturnCode

Devuelve un código de estado para el examen por parte de la aplicación solicitante.

Length

Indica el tamaño en bytes del área de datos inmediatamente siguiente. Esta área se puede dividir para la operación concreta en áreas de entrada y salida. Para las solicitudes de entrada, el contenido de DataBuffer se copiará en el solicitante hasta el valor devuelto de DataTransferLength.

Comentarios

Las aplicaciones usan esta estructura para enviar solicitudes directamente a un HBA dedicado a la aplicación. Tenga en cuenta que esta aplicación también debe configurar solicitudes para programar su HBA dedicado.

Requisitos

Requisito Valor
Header ntddscsi.h (incluya Ntddscsi.h)

Consulte también

Códigos de control de E/S de puerto SCSI

SCSI_REQUEST_BLOCK