StorPortInterlockedInsertHeadList 関数 (storport.h)

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

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

構文

ULONG StorPortInterlockedInsertHeadList(
  [in]      PVOID            HwDeviceExtension,
  [in, out] PSTOR_LIST_ENTRY ListHead,
  [in, out] PSTOR_LIST_ENTRY ListEntry,
  [in, out] PSTOR_LIST_ENTRY *Result,
  [in, out] PSTOR_KSPIN_LOCK Lock
);

パラメーター

[in] HwDeviceExtension

ホストバスアダプター (HBA) のハードウェアデバイス拡張機能へのポインター。

[in, out] ListHead

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

[in, out] ListEntry

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

[in, out] Result

新しい エントリが挿入 される前のリストの最初のエントリを表すSTOR_LIST_ENTRY構造体へのポインター。

[in, out] Lock

リストへのアクセスを同期するために使用されるスピンロックとして機能する STOR_KSPIN_LOCK 構造体へのポインター。スピンロックのストレージは常駐であり、 StorPortInitializeSpinLock を呼び出して初期化されている必要があります。

このスピンロックは 、StorPortInterlockedXxxList ルーチンでのみ使用する必要があります。

戻り値

StorPortInterlockedInsertHeadList は、次のいずれかの状態コードを返します。

リターンコード	説明
STOR_STATUS_NOT_IMPLEMENTED	この関数は、アクティブなオペレーティングシステムには実装されません。
STOR_STATUS_SUCCESS	リストアイテムが正常に削除されたか、リストが既に空です。
STOR_STATUS_INVALID_PARAMETER	ListHead または Result のポインターが NULL です。