Fungsi StorPortCancelDpc (storport.h)

Artikel
02/26/2024

StorPortCancelDpc mencoba membatalkan eksekusi panggilan prosedur yang ditangguhkan StorPort (DPC).

Sintaks

ULONG StorPortCancelDpc(
  PVOID     HwDeviceExtension,
  PSTOR_DPC Dpc,
  BOOLEAN   *ReturnValue
);

Parameter

HwDeviceExtension

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

Dpc

Penunjuk ke objek STOR_DPC DPC yang akan dibatalkan.

ReturnValue

Penunjuk ke BOOLEAN di mana fungsi ini akan mengembalikan salah satu nilai berikut.

Tampilkan Nilai	Deskripsi
TRUE	Dpc yang ditentukan berhasil dihapus dari antrean DPC sistem.
FALSE	Dpc yang ditentukan tidak dihapus dari antrean DPC sistem.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu kode status berikut.

Kode Pengembalian	Deskripsi
STOR_STATUS_INVALID_PARAMETER	Dpc atau ReturnValue adalah NULL.
STOR_STATUS_NOT_IMPLEMENTED	Fungsi ini tidak diimplementasikan pada sistem operasi aktif.
STOR_STATUS_SUCCESS	Fungsi ini berhasil diselesaikan. Gunakan nilai yang dikembalikan dalam ReturnValue untuk menentukan apakah Dpc dihapus dari antrean.

Keterangan

Jika StorPort DPC yang ditentukan berada dalam antrean DPC, StorPortCancelDpc menghapusnya dari antrean, membatalkan panggilan ke rutinitas DPC terkait. Jika tidak dalam antrean, itu sedang dieksekusi atau telah selesai dieksekusi, dan oleh karena itu tidak dapat dihapus.

Rutinitas ini diimplementasikan menggunakan definisi fungsi sebaris, sehingga driver miniport yang menggunakannya tidak perlu menautkan ke pustaka yang bergantung pada versi sistem operasi. Driver Miniport dapat menggunakan rutinitas ini tanpa mengorbankan kompatibilitas mundur dengan versi sistem operasi yang tidak mendukung DPC di driver miniport penyimpanan.

Persyaratan

Persyaratan	Nilai
Header	storport.h

Lihat juga

STOR_DPC

StorPortInitializeDpc

StorPortIssueDpc

Bagikan melalui