StorPortInitializeSListHead 関数 (storport.h)

  • [アーティクル]

Storport で管理される 1 つのリンク リストの先頭を初期化します。

構文

ULONG StorPortInitializeSListHead(
  [in]      PVOID              HwDeviceExtension,
  [in, out] PSTOR_SLIST_HEADER SListHead
);

パラメーター

[in] HwDeviceExtension

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

[in, out] SListHead

1 つのリンクされたリストの先頭を表す STOR_SLIST_HEADER 構造体へのポインター。 この構造体は不透明と見なされ、Storport ドライバーでのみ使用されます。

戻り値

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

リターン コード 説明
STOR_STATUS_NOT_IMPLEMENTED
 この関数は、アクティブなオペレーティング システムには実装されていません。
STOR_STATUS_SUCCESS
 SListHead が指すリスト ヘッドが正常に初期化されました。
STOR_STATUS_INVALID_PARAMETER
 SListHead のポインターは NULL です。

注釈

呼び出し元によって割り当てられる場合、SListHead が指すSTOR_SLIST_HEADER構造体は、MEMORY_ALLOCATION_ALIGNMENT境界に配置する必要があります。 MEMORY_ALLOCATION_ALIGNMENT は 、miniport.h で定義されています。

リスト ヘッドのメモリが解放されると、割り当て解除コードは、MEMORY_ALLOCATION_ALIGNMENTの調整の前に、リスト ヘッド構造を含むバッファーの元の場所を考慮する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8 以降で使用できます。
対象プラットフォーム ユニバーサル
Header storport.h (Storport.h を含む)
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

StorPortInterlockedFlushSList

StorPortInterlockedPopEntrySList

StorPortInterlockedPushEntrySList

StorPortQueryDepthSList