Fungsi StorPortPutScatterGatherList (storport.h)

  • Artikel

Rutinitas StorPortPutScatterGatherList merilis sumber daya apa pun yang terkait dengan daftar sebar/kumpulkan yang sebelumnya dibuat oleh panggilan ke rutinitas StorPortBuildScatterGatherList .

Sintaks

ULONG StorPortPutScatterGatherList(
  [in] PVOID                     HwDeviceExtension,
  [in] PSTOR_SCATTER_GATHER_LIST ScatterGatherList,
  [in] BOOLEAN                   WriteToDevice
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat keras untuk adaptor bus host (HBA).

[in] ScatterGatherList

Penunjuk ke buffer yang berisi daftar sebar/kumpulkan yang sebelumnya dibuat oleh panggilan ke rutinitas StorPortBuildScatterGatherList .

[in] WriteToDevice

Nilai yang menunjukkan arah transfer DMA yang telah selesai. Nilai TRUE menunjukkan transfer dari buffer data ke perangkat, dan FALSE menunjukkan transfer dari perangkat ke buffer data.

Nilai kembali

StorPortPutScatterGatherList mengembalikan salah satu kode status berikut:

Menampilkan kode Deskripsi
STOR_STATUS_NOT_IMPLEMENTED
 Fungsi ini tidak diimplementasikan pada sistem operasi aktif.
STOR_STATUS_SUCCESS
 Menunjukkan bahwa rutinitas berhasil merilis daftar sebar/kumpulkan.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension yang diteruskan adalah NULL.
STOR_STATUS_INVALID_IRQL
 Panggilan dilakukan pada IRQL yang tidak valid.

Keterangan

Rutinitas StorPortPutScatterGatherList tidak membebaskan memori buffer untuk daftar sebar/kumpulkan, karena driver miniport mengalokasikan memori ini.

Setelah rutinitas StorPortPutScatterGatherList kembali, driver miniport dapat menggunakan kembali buffer untuk membuat daftar sebar/kumpulkan baru dengan memanggil StorPortBuildScatterGatherList lagi. Jika driver miniport telah selesai menggunakan buffer untuk daftar sebar/kumpulkan, itu harus membebaskan memori untuk buffer setelah rutinitas StorPortPutScatterGatherList kembali. Jika driver miniport mengalokasikan memori buffer dengan rutinitas StorPortAllocatePool , driver miniport harus membebaskan memori dengan memanggil rutinitas StorPortFreePool .

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header storport.h (termasuk Storport.h)
IRQL DISPATCH_LEVEL
Aturan kepatuhan DDI StorPortIrql(storport)

Lihat juga

StorPortBuildScatterGatherList