struttura SRB_IO_CONTROL (ntddscsi.h)

Articolo
02/29/2024

Nota I modelli di driver di porta SCSI e miniport SCSI potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare il driver Storport e i modelli di driver miniport Storport .

Sintassi

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

Members

HeaderLength

Sizeof(SRB_IO_CONTROL).

Signature[8]

Identifica l'HBA di destinazione dedicata all'applicazione per questa richiesta. Questa firma viene usata per evitare conflitti nei valori ControlCode tra i fornitori. Deve essere una stringa di caratteri ASCII. Se un driver miniport non riconosce il valore della firma di input, deve completare la richiesta con lo stato SRB_STATUS_INVALID_REQUEST.

Timeout

Indica l'intervallo in secondi che la richiesta può essere eseguita prima che il driver di porta specifico del sistema operativo possa considerarlo timeout. I driver Miniport devono applicare timeout per SRB_IO_CONTROL, in particolare per qualsiasi SRB_IO_CONTROL definita privatamente.

ControlCode

Indica l'operazione da eseguire. Non sono presenti operazioni definite dal sistema. I valori devono essere definiti dal driver come set di codici di controllo di I/O privati con cui l'applicazione può effettuare richieste chiamando la funzione DeviceIoControl Win32. Per altre informazioni sulla definizione dei codici di controllo di I/O privati per le richieste di controllo dei dispositivi, vedere Uso dei codici di controllo di I/O.

ReturnCode

Restituisce un codice di stato per l'esame da parte dell'applicazione richiedente.

Length

Indica le dimensioni in byte dell'area dati immediatamente successiva. Questa area può essere divisa per la particolare operazione in aree di input e output. Per le richieste di input, il contenuto di DataBuffer verrà copiato nel richiedente fino al valore restituito di DataTransferLength.

Commenti

Questa struttura viene usata dalle applicazioni per inviare richieste direttamente a un HBA dedicato all'applicazione. Si noti che tale applicazione deve anche configurare le richieste per programmare la propria HBA dedicata.

Requisiti

Requisito	Valore
Intestazione	ntddscsi.h (include Ntddscsi.h)

Vedi anche

Codici di controllo I/O delle porte SCSI

SCSI_REQUEST_BLOCK

Condividi tramite