Fungsi StorPortIssueDpc (storport.h)

  • Artikel

Rutinitas StorPortIssueDpc mengeluarkan panggilan prosedur yang ditangguhkan (DPC).

Sintaks

BOOLEAN StorPortIssueDpc(
  [in] PVOID     DeviceExtension,
  [in] PSTOR_DPC Dpc,
  [in] PVOID     SystemArgument1,
  [in] PVOID     SystemArgument2
);

Parameter

[in] DeviceExtension

Arahkan ke ekstensi perangkat per adaptor.

[in] Dpc

Penunjuk ke buffer yang berisi objek DPC berjenis inisialisasi STOR_DPC yang dikembalikan oleh rutinitas StorPortInitializeDpc .

[in] SystemArgument1

Pointer ke informasi yang disediakan penelepon yang akan diteruskan ke rutinitas yang ditangguhkan.

[in] SystemArgument2

Pointer ke informasi yang disediakan penelepon yang akan diteruskan ke rutinitas yang ditangguhkan.

Nilai kembali

Rutinitas StorPortIssueDpc mengembalikan TRUE jika DPC berhasil dimasukkan ke dalam antrean DPC, dan FALSE sebaliknya.

Keterangan

Rutinitas StorPortIssueDpc memanggil rutinitas kernel KeInsertQueueDpc untuk mengantre DPC. Rutinitas kernel KeInsertQueueDpc tidak memungkinkan DPC untuk diantrekan beberapa kali. Dengan demikian, jika objek DPC yang ditentukan oleh parameter Dpc sudah berada dalam antrean DPC, KeInsertQueueDpc mengabaikan permintaan antrean. Ini memastikan bahwa rutinitas yang ditangguhkan yang diinisialisasi dengan StorPortInitializeDpc selalu disinkronkan dengan dirinya sendiri. Dengan kata lain, penelepon tidak perlu mengurutkan panggilan ke rutinitas StorPortIssueDpc untuk memastikan bahwa beberapa instans rutin tidak berjalan secara bersamaan.

Jika driver miniport memiliki beberapa item kerja yang harus dilakukan oleh DPC yang sama, driver miniport harus memastikan bahwa setiap item kerja selesai sebelum mengeluarkan DPC untuk item kerja berikutnya.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header storport.h (termasuk Storport.h)

Lihat juga

KeInsertQueueDpc

STOR_DPC

StorPortInitializeDpc