IAVIStream

IAVIStream インターフェイスは、ファイル内のデータストリームの作成と操作をサポートします。IUnknown::QueryInterface、IUnknown::AddRef、IUnknown::Release に加えて、次のカスタムメソッドを使用します。

Create メソッドは、どのファイルにも関連付けられていないストリームハンドラーを初期化します。アプリケーションが AVIStreamCreate 関数を使用したときに呼び出されます。

OLE で定義された HRESULT を返します。

C++ で記述されたハンドラーの場合、Create の構文は次のとおりです。

HRESULT Create(LONG lParam1, LONG lParam2) 
 

Info メソッドは、ストリームに関する情報を AVISTREAMINFO 構造体に格納して返します。アプリケーションが AVIStreamInfo 関数を使用したときに呼び出されます。

OLE で定義された HRESULT を返します。

割り当てられたバッファーが構造体に対して小さすぎる場合、Info メソッドは AVIERR_BUFFERTOOSMALL を返して呼び出しを失敗させる必要があります。それ以外の場合は、構造体を格納し、そのサイズを返す必要があります。

C++ で記述されたハンドラーの場合、Info の構文は次のとおりです。

HRESULT Info(AVIFILEINFO *psi, LONG lSize) 
 

FindSample メソッドは、ストリーム内のキーフレームまたは空でないフレームの位置を取得します。アプリケーションが AVIStreamFindSample 関数を使用したときに呼び出されます。

アプリケーションが指定したフレームに対応するキーフレームの位置を返します。

カスタムフォーマットにおいてキーフレームが重要でない場合は、lPos に指定された位置を返してください。

C++ で記述されたハンドラーの場合、FindSample の構文は次のとおりです。

LONG FindSample(LONG lPos, LONG lFlags) 
 

ReadFormat メソッドは、ストリームからフォーマット情報を取得します。

OLE で定義された HRESULT を返します。

ストリームに格納されるデータの種類によって、フォーマット情報と、それを格納する構造体が決まります。ストリームハンドラーは、フォーマットがパレットを使用する場合のパレット情報を含め、適用されるすべてのフォーマット情報をこの構造体で返す必要があります。ストリームハンドラーは、この構造体でストリームデータを返してはなりません。

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

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

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

SetFormat メソッドは、ストリームにフォーマット情報を設定します。アプリケーションが AVIStreamSetFormat 関数を使用したときに呼び出されます。

OLE で定義された HRESULT を返します。

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

C++ で記述されたハンドラーの場合、SetFormat の構文は次のとおりです。

HRESULT SetFormat(LONG lPos, LPVOID lpFormat, LONG cbFormat) 
 

Read メソッドは、ストリームからデータを読み取り、アプリケーション定義のバッファーにコピーします。バッファーが指定されていない場合は、次のデータバッファーを取得するために必要なバッファーサイズを判定します。アプリケーションが AVIStreamRead 関数を使用したときに呼び出されます。

成功した場合は AVIERR_OK を返し、バッファーがデータを保持するのに十分な大きさでない場合は AVIERR_BUFFERTOOSMALL を返します。成功した場合、Read はバッファーに含まれるフレーム (サンプル) 数を伴うデータバッファー、または必要なバッファーサイズ (バイト単位) のいずれかも返します。

C++ で記述されたハンドラーの場合、Read の構文は次のとおりです。

HRESULT Read(LONG lStart, LONG lSamples, 
    LPVOID lpBuffer, LONG cbBuffer, 
    LONG *plBytes, LONG *plSamples); 
 

Write メソッドは、ストリームにデータを書き込みます。アプリケーションが AVIStreamWrite 関数を使用したときに呼び出されます。

OLE で定義された HRESULT を返します。

C++ で記述されたハンドラーの場合、Write の構文は次のとおりです。

HRESULT Write(LONG lStart, LONG lSamples, LPVOID lpBuffer, 
    LONG cbBuffer, DWORD dwFlags, LONG *plSampWritten, 
    LONG *plBytesWritten); 
 

Delete メソッドは、ストリームからデータを削除します。

OLE で定義された HRESULT を返します。

C++ で記述されたハンドラーの場合、Delete の構文は次のとおりです。

HRESULT Delete(LONG lStart, LONG lSamples); 
 

ReadData メソッドは、ストリームのデータヘッダーを読み取ります。アプリケーションが AVIStreamReadData 関数を使用したときに呼び出されます。

OLE で定義された HRESULT を返します。

C++ で記述されたハンドラーの場合、ReadData の構文は次のとおりです。

HRESULT ReadData(DWORD fcc, LPVOID lp, LONG *lpcb); 
 

WriteData メソッドは、ストリームのヘッダーを書き込みます。アプリケーションが AVIStreamWriteData 関数を使用したときに呼び出されます。

OLE で定義された HRESULT を返します。

C++ で記述されたハンドラーの場合、WriteData の構文は次のとおりです。

HRESULT WriteData(DWORD fcc, LPVOID lpBuffer, LONG cbBuffer);