CBaseList クラス

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

cbaselist クラス階層

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 基本クラス