Fungsi InsertHeadList (wdm.h)

Artikel
02/29/2024

Rutinitas InsertHeadList menyisipkan entri di kepala daftar struktur LIST_ENTRY yang ditautkan ganda.

Sintaks

void InsertHeadList(
  [in, out] PLIST_ENTRY                  ListHead,
  [in, out] __drv_aliasesMem PLIST_ENTRY Entry
);

Parameter

[in, out] ListHead

Arahkan ke struktur LIST_ENTRY yang mewakili kepala daftar.

[in, out] Entry

Penunjuk ke struktur LIST_ENTRY yang mewakili entri yang akan disisipkan ke dalam daftar.

Nilai kembali

Tidak ada

Keterangan

InsertHeadList memperbarui ListHead-Flink> untuk menunjuk ke Entri. Ini memperbarui Entry-Flink> untuk menunjuk ke entri pertama lama dalam daftar, dan mengatur Entry-Blink> ke ListHead. Bidang Blink dari entri pertama asli juga diperbarui untuk menunjuk ke Entri.

Untuk informasi tentang menggunakan rutinitas ini saat menerapkan daftar tertaut doubly, lihat Lists Tertaut Singly dan Doubly.

Penelepon InsertHeadList dapat berjalan di IRQL apa pun. Jika InsertHeadList dipanggil di IRQL >= DISPATCH_LEVEL, penyimpanan untuk ListHead dan entri daftar harus residen.

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, Wudfwdm.h)
IRQL	Tingkat apa pun (Lihat bagian Keterangan)
Aturan kepatuhan DDI	IoAllocateFree(wdm), IoReuseIrp(wdm), MarkingQueuedIrps(wdm), RemoveLockCheck(wdm), RemoveLockForward(wdm), RemoveLockForward2(wdm), RemoveLockForwardDeviceControl(wdm), RemoveLockForwardDeviceControl2(wdm), RemoveLockForwardDeviceControlInternal(wdm), RemoveLockForwardDeviceControlInternal2(wdm), RemoveLockForwardRead(wdm), RemoveLockForwardRead2(wdm) , RemoveLockForwardWrite(wdm), RemoveLockForwardWrite2(wdm), RemoveLockRelease2(wdm), RemoveLockReleaseCleanup(wdm), RemoveLockReleaseClose(wdm), RemoveLockReleaseCreate(wdm), RemoveLockReleaseDeviceControl(wdm), RemoveLockReleaseInternalDeviceControl(wdm), RemoveLockReleasePower(wdm), RemoveLockReleaseRead(wdm), RemoveLockReleaseShutdown(wdm), RemoveLockReleaseSystemControl(wdm), RemoveLockReleaseWrite(wdm)