struktur SRB_IO_CONTROL (ntddscsi.h)

  • Artikel
Catatan Driver port SCSI dan model driver miniport SCSI dapat diubah atau tidak tersedia di masa mendatang. Sebagai gantinya, sebaiknya gunakan driver Storport dan model driver miniport Storport .
 

Sintaks

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

Anggota

HeaderLength

Adalah sizeof(SRB_IO_CONTROL).

Signature[8]

Mengidentifikasi HBA target khusus aplikasi untuk permintaan ini. Tanda tangan ini digunakan untuk mencegah konflik dalam nilai ControlCode antar vendor. Ini harus berupa string karakter ASCII. Jika driver miniport tidak mengenali nilai Tanda Tangan input, driver tersebut harus menyelesaikan permintaan dengan status SRB_STATUS_INVALID_REQUEST.

Timeout

Menunjukkan interval dalam hitungan detik yang dapat dijalankan permintaan sebelum driver port khusus OS mungkin menganggapnya kehabisan waktu. Driver miniport harus memberlakukan batas waktu untuk SRB_IO_CONTROL, terutama untuk SRB_IO_CONTROL yang ditentukan secara privat.

ControlCode

Menunjukkan operasi yang akan dilakukan. Tidak ada operasi yang ditentukan sistem. Nilai harus didefinisikan oleh driver sebagai sekumpulan kode kontrol I/O privat yang dengannya aplikasi dapat membuat permintaan dengan memanggil fungsi Win32 DeviceIoControl . Untuk informasi selengkapnya tentang menentukan kode kontrol I/O privat untuk permintaan kontrol perangkat, lihat Menggunakan Kode Kontrol I/O.

ReturnCode

Mengembalikan kode status untuk pemeriksaan oleh aplikasi yang meminta.

Length

Menunjukkan ukuran dalam byte area data berikut segera. Area ini dapat dibagi untuk operasi tertentu menjadi area input dan output. Untuk permintaan input, konten DataBuffer akan disalin ke pemohon hingga nilai DataTransferLength yang dikembalikan.

Keterangan

Struktur ini digunakan oleh aplikasi untuk mengirim permintaan langsung ke HBA khusus aplikasi. Perhatikan bahwa aplikasi semacam itu juga harus menyiapkan permintaan untuk memprogram HBA khususnya.

Persyaratan

Persyaratan Nilai
Header ntddscsi.h (termasuk Ntddscsi.h)

Lihat juga

Kode Kontrol I/O Port SCSI

SCSI_REQUEST_BLOCK