IMFASFIndexer::GetIndexWriteSpace メソッド (wmcontainer.h)

  • [アーティクル]

完成したインデックスを格納するために必要なバッファーのサイズをバイト単位で取得します。

構文

HRESULT GetIndexWriteSpace(
  [out] QWORD *pcbIndexWriteSpace
);

パラメーター

[out] pcbIndexWriteSpace

インデックスのサイズをバイト単位で受け取ります

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_INDEX_NOT_COMMITTED
 インデックスがコミットされていません。 詳細については、以下を参照してください。「解説」を参照してください。

注釈

インデックスのサイズを取得し、それを保持するのに十分な大きさのバッファーを割り当てるには、このメソッドを使用します。

インデックスは、IMFASFIndexer::GetIndexWriteSpace を呼び出す前に、 IMFASFIndexer::CommitIndex の呼び出しでコミットする必要があります。 GetIndexWriteSpace が呼び出される前にインデックスがコミットされていない場合は、結果としてMF_E_INDEX_NOT_COMMITTEDが返されます。

IMFASFIndexer::GetCompletedIndex を呼び出して、完成したインデックスをメディア バッファーに書き込みます。

このメソッドは、読み取りシナリオでは使用できません。 このメソッドは、インデックスを作成する場合にのみ使用できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wmcontainer.h
Library Mfuuid.lib

こちらもご覧ください

ASF Index オブジェクト

IMFASFIndexer