Fungsi StorPortIssueDpc (storport.h)
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) |