SRB_IO_CONTROL estrutura (ntddscsi.h)

Artigo
02/07/2025

Observação o driver de porta SCSI e os modelos de driver de miniporto SCSI podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

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

É tamanho de(SRB_IO_CONTROL).

Signature[8]

Identifica o HBA de destino dedicado ao aplicativo para essa solicitação. Essa assinatura é usada para evitar conflitos em ControlCode valores entre fornecedores. Deve ser uma cadeia de caracteres ASCII. Se um driver de miniporto não reconhecer a entrada valor de assinatura, 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 miniporto devem impor tempos limite para SRB_IO_CONTROL, especialmente para qualquer SRB_IO_CONTROL definida privadamente.

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 DeviceIoControl win32. 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 de 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.

Observações

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 (include Ntddscsi.h)

Consulte também

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

SCSI_REQUEST_BLOCK

Partilhar via