estrutura SRB_IO_CONTROL (ntddscsi.h)

  • Artigo
Nota Os modelos de driver de porta SCSI e driver de miniporto SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver do Storport e do driver de miniporto storport .
 

Sintaxe

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

Membros

HeaderLength

É sizeof(SRB_IO_CONTROL).

Signature[8]

Identifica o HBA de destino dedicado ao aplicativo para essa solicitação. Essa assinatura é usada para evitar conflitos nos valores de ControlCode entre fornecedores. Deve ser uma cadeia de caracteres ASCII. Se um driver de miniporto não reconhecer o valor de Assinatura de entrada, ele deverá concluir a solicitação com um status de SRB_STATUS_INVALID_REQUEST.

Timeout

Indica o intervalo em segundos que a solicitação pode ser executada antes que o driver de porta específico do sistema operacional considere o tempo limite. Os drivers de miniport devem impor tempos limite para SRB_IO_CONTROL, especialmente para qualquer SRB_IO_CONTROL definido de forma privada.

ControlCode

Indica a operação a ser executada. Não há operações definidas pelo sistema. Os valores devem ser definidos pelo driver como um conjunto de códigos de controle de E/S privados com os quais o aplicativo pode fazer solicitações chamando a função Win32 DeviceIoControl . Para obter mais informações sobre como definir códigos de controle de E/S privados para solicitações de controle de dispositivo, consulte Usando códigos de controle de E/S.

ReturnCode

Retorna um código status para exame pelo aplicativo solicitante.

Length

Indica o tamanho em bytes da área de dados imediatamente a seguir. Essa área pode ser dividida para a operação específica em áreas de entrada e saída. Para solicitações de entrada, o conteúdo do DataBuffer será copiado para o solicitante até o valor retornado de DataTransferLength.

Comentários

Essa estrutura é usada por aplicativos para enviar solicitações diretamente para um HBA dedicado ao aplicativo. Observe que esse aplicativo também deve configurar solicitações para programar seu HBA dedicado.

Requisitos

Requisito Valor
Cabeçalho ntddscsi.h (inclua Ntddscsi.h)

Confira também

Códigos de controle de E/S da porta SCSI

SCSI_REQUEST_BLOCK