Fungsi IoCopyCurrentIrpStackLocationToNext (wdm.h)

  • Artikel

Rutinitas IoCopyCurrentIrpStackLocationToNext menyalin parameter tumpukan IRP dari lokasi tumpukan I/O saat ini ke lokasi tumpukan driver berikutnya yang lebih rendah.

Sintaks

void IoCopyCurrentIrpStackLocationToNext(
  [in, out] PIRP Irp
);

Parameter

[in, out] Irp

Penunjuk ke IRP.

Nilai kembali

Tidak ada

Keterangan

Driver memanggil IoCopyCurrentIrpStackLocationToNext untuk menyalin parameter IRP dari lokasi tumpukannya ke lokasi tumpukan driver berikutnya yang lebih rendah.

Setelah memanggil rutinitas ini, driver biasanya mengatur rutinitas penyelesaian I/O dengan IoSetCompletionRoutine sebelum meneruskan IRP ke driver berikutnya yang lebih rendah dengan IoCallDriver. Driver yang meneruskan parameter IRP mereka tetapi tidak mengatur rutinitas penyelesaian I/O harus memanggil IoSkipCurrentIrpStackLocation alih-alih rutinitas ini.

Jika driver Anda memanggil IoSkipCurrentIrpStackLocation, berhati-hatilah untuk tidak memodifikasi struktur IO_STACK_LOCATION dengan cara yang secara tidak sengaja dapat memengaruhi driver yang lebih rendah atau perilaku sistem sehubungan dengan driver tersebut. Secara khusus, driver Anda tidak boleh memodifikasi gabungan Parameter struktur IO_STACK_LOCATION, dan tidak boleh memanggil rutinitas IoMarkIrpPending.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL <=DISPATCH_LEVEL

Lihat juga

IO_STACK_LOCATION

IoCallDriver

IoMarkIrpPending

IoSetCompletionRoutine

IoSkipCurrentIrpStackLocation