CBaseList クラス

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

CBaseList メソッドは、アブロック リストを実装します。 CBaseList から派生した CGenericList クラス テンプレートは、CBaseList クラスよりも型チェックとシンプルなインターフェイスを提供します。

CBaseList クラスは、Microsoft Foundation Classes (MFC) ライブラリの CObList クラスの後にモデル化されます。 リスト内の位置は POSITION 構造体で表されます。 呼び出し元は POSITION 構造体の内部メンバーにアクセスしないでください。リスト ノードへのポインターとして扱います。 リスト内のオブジェクトの位置は、オブジェクトが削除されるまで有効なままです。

リストに含まれるオブジェクトによるサポートは必要ありません。 オブジェクトに対するストレージ管理やコピーは実行されません。 オブジェクトは複数のリストに含めることができます。

このクラスのメソッドの約半分は、単一のオブジェクトに対して動作します。 これらのメソッドには、メソッド名にサフィックス I が付いています。 その他のメソッドは、リスト全体に対して機能します。 たとえば、 CBaseList::AddAfter メソッドはリストを別のリストに追加します。 単一オブジェクト操作は POSITION 値を返し、失敗した場合は NULL を 返します。 リスト操作が成功した場合 は TRUE、 それ以外の場合 は FALSE を 返します。

保護されたメンバー変数	説明
m_Count	リスト内のアイテムの数。
m_pFirst	リスト内の最初のノードへのポインター。
m_pLast	リスト内の最後のノードへのポインター。
プロテクト メソッド	説明
GetNextI	指定した位置にある項目を取得し、位置を進めます。
GetI	指定した位置にある項目を取得します。
FindI	指定した項目を保持する最初の位置を取得します。
RemoveHeadI	リスト内の最初の項目を削除します。
RemoveTailI	リスト内の最後の項目を削除します。
RemoveI	指定した位置にある項目を削除します。
AddTailI	リストの末尾に項目を追加します。
AddHeadI	リストの先頭に項目を追加します。
AddAfterI	指定した位置の後に項目を挿入します。
AddBeforeI	指定した位置の前に項目を挿入します。
パブリック メソッド	説明
CBaseList	コンストラクター メソッド。
~ CBaseList	デストラクター メソッド。
RemoveAll	リストからすべてのノードを削除します。
GetHeadPositionI	リスト内の最初の項目の位置を取得します。
GetTailPositionI	リストの最後の項目の位置を取得します。
GetCountI	リスト内の項目の数を取得します。
次へ	リスト内の次の位置を取得します。
前	リスト内の前の位置を取得します。
AddHead	このリストの先頭に別のリストを挿入します。
AddTail	このリストの末尾に別のリストを追加します。
AddAfter	指定した位置の後にリストを挿入します。
AddBefore	指定した位置の前にリストを挿入します。
MoveToTail	リストを分割し、別のリストの末尾に頭の部分を追加します。
MoveToHead	リストを分割し、末尾部分を別のリストの先頭に挿入します。
逆	リストの順序を逆にします。

要件

要件	値
ヘッダー	Wxlist.h (Streams.h を含む)
ライブラリ	Strmbase.lib (製品版ビルド); Strmbasd.lib (デバッグ ビルド)

関連項目

DirectShow 基本クラス