InsertHeadList 関数 (wdm.h)

[アーティクル]
08/08/2023

InsertHeadList ルーチンは、LIST_ENTRY構造体の二重にリンクされたリストの先頭にエントリを挿入します。

構文

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

パラメーター

[in, out] ListHead

リストの先頭を表す LIST_ENTRY 構造体へのポインター。

[in, out] Entry

リストに挿入するエントリを表す LIST_ENTRY 構造体へのポインター。

戻り値

なし

解説

InsertHeadList は、ListHead-Flink> を更新して Entry をポイントします。 Entry-Flink> を更新して、リスト内の古い最初のエントリをポイントし、Entry-Blink> を ListHead に設定します。元の最初のエントリの Blink フィールドも、Entry をポイントするように更新 されます。

二重リンクリストを実装するときにこのルーチンを使用する方法については、「Singly および Do2ly Linked Lists」を参照してください。

InsertHeadList の呼び出し元は、任意の IRQL で実行できます。 IRQL >= DISPATCH_LEVEL で InsertHeadList が呼び出される場合、ListHead のストレージとリストエントリは常駐している必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	デスクトップ
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h を含む)
IRQL	任意のレベル (「解説」セクションを参照)
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)、 RemoveLockReleaseShutdownt(wdm)、 RemoveLockReleaseSystemControl(wdm)、 RemoveLockReleaseWrite(wdm)