IAVIStream::ReadFormat メソッド (vfw.h)

  • [アーティクル]

ReadFormat メソッドは、ストリームから形式情報を取得します。 アプリケーション定義バッファー内のデータを構造体に入力して返します。 バッファーが指定されていない場合は、フォーマット データのバッファーを取得するために必要なバッファー サイズを決定します。 アプリケーションが AVIStreamReadFormat 関数を使用するときに呼び出されます。

構文

HRESULT ReadFormat(
  LONG   lPos,
  LPVOID lpFormat,
  LONG   *lpcbFormat
);

パラメーター

lPos

サンプルまたはフレームの位置。

lpFormat

書式設定データのバッファーへのポインター。 バッファーの必要なサイズを要求するには 、NULL を 指定します。

lpcbFormat

lpFormat で指定されたバッファーのサイズ (バイト単位) を受け取るバッファーへのポインター。 このメソッドが呼び出されると、このパラメーターの内容は lpFormat で指定されたバッファーのサイズを示します。 このメソッドがアプリケーションに制御を返すとき、このパラメーターの内容は、読み取られたデータの量またはバッファーの必要なサイズを指定します。

戻り値

OLE で定義されている HRESULT を返します。

注釈

ストリームに格納されているデータの種類によって、書式情報と、書式情報を含む構造体が決まります。 ストリーム ハンドラーは、書式でパレットを使用する場合のパレット情報を含め、この構造体内のすべての適用可能な書式情報を返す必要があります。 ストリーム ハンドラーは、 構造体を持つストリーム データを返すべきではありません。

標準のビデオ ストリーム ハンドラーは、 BITMAPINFOHEADER 構造体の形式情報を提供します。 標準のオーディオ ストリーム ハンドラーは、 PCMWAVEFORMAT 構造体の形式情報を提供します。 他のデータ ストリームでは、ストリーム データを記述する他の構造体を使用できます。

C++ で記述されたハンドラーの場合、 ReadFormat には次の構文があります。


HRESULT ReadFormat(LONG lPos, LPVOID lpFormat, 
    LONG *lpcbFormat)

要件

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

こちらもご覧ください

カスタム ファイルおよびStream ハンドラー インターフェイス

カスタム ファイルハンドラーとStream ハンドラー