Fungsi ScsiPortStallExecution (srb.h)

Artikel
02/29/2024

Stall rutin ScsiPortStallExecution di pengemudi miniport.

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

SCSIPORT_API VOID ScsiPortStallExecution(
  [in] ULONG Delay
);

Parameter

[in] Delay

Menentukan interval penundaan dalam mikrodetik. Nilai yang diberikan harus kurang dari milidetik penuh.

Nilai kembali

Tidak ada

Keterangan

ScsiPortStallExecution harus dipanggil sebisa mungkin dan total waktu stall dalam rutinitas driver miniport harus kurang dari satu milidetik. Panggilan ini mengikat prosesor, tidak melakukan pekerjaan yang berguna saat mengulur-ulur driver.

Secara umum, driver miniport harus memanggil ScsiPortStallExecution hanya jika driver harus menunggu perubahan status pada HBA yang tidak dapat menyebabkan gangguan, atau jika driver harus menunda untuk interval yang sangat singkat antara akses ke HBA.

Jika rutinitas HwScsiInterrupt driver miniport harus mengulur antara akses ke HBA dan total waktu penundaan di ISR mungkin lebih dari satu milidetik, HwScsiInterrupt harus memanggil ScsiPortNotification dengan NotificationTypeCallEnableInterrupts alih-alih memanggil ScsiPortStallExecution. Driver miniport seperti itu memiliki sepasang HwScsi.. Rutinitas InterruptsCallback untuk mengelola pemrosesan I/O yang digerakkan interupsi tanpa mengikat prosesor dan menurunkan performa I/O HBA lain yang mungkin didukung driver miniport di komputer yang sama.

Rutinitas HwScsiTimer yang disediakan driver miniport juga dapat diteruskan dalam panggilan ke ScsiPortNotification dengan interval tertentu yang tidak terbatas pada satu milidetik.