Microsoft DirectX 8.0 |
これらの関数は、DMO_MEDIA_TYPE 構造体を操作する。これらの関数は Dmort.h ファイルで宣言される。
MoInitMediaType メディア タイプ構造体を初期化する。 MoFreeMediaType メディア タイプ構造体の割り当て済みのメンバを解放する。 MoCopyMediaType 1 つのメディア タイプ構造体のメンバを別のメディア タイプ構造体にコピーする。 MoCreateMediaType 新しいメディア タイプ構造体を割り当てる。 MoDeleteMediaType 前に割り当てられたメディア タイプ構造体を削除する。 MoDuplicateMediaType メディア タイプ構造体を複製する。
メディア タイプ構造体を初期化する。
構文
HRESULT MoInitMediaType( DMO_MEDIA_TYPE *pmt, DWORD cbFormat );
パラメータ
- pmt
- 呼び出し元によって割り当てられており、初期化されていない DMO_MEDIA_TYPE 構造体を指すポインタ。
- cbFormat
- フォーマット ブロックに割り当てるバイトの数。0 も指定できる。
戻り値
HRESULT 値を返す。以下の値をとる。
S_OK 成功 E_OUTOFMEMORY メモリ不足 E_POINTER NULL ポインタ引数
注意
この関数はフォーマット ブロックを割り当てて、DMO_MEDIA_TYPE 構造体の cbFormat メンバと pbFormat メンバを設定する。
呼び出し元は、MoFreeMediaType 関数を呼び出すことによってメディア タイプを解放する必要がある。
メディア タイプ構造体の割り当て済みのメンバを解放する。
構文
HRESULT MoFreeMediaType( DMO_MEDIA_TYPE *pmt );
パラメータ
- pmt
- 初期化された DMO_MEDIA_TYPE 構造体を指すポインタ。
戻り値
HRESULT 値を返す。以下の値をとる。
S_OK 成功 E_POINTER NULL ポインタ引数
注意
この関数は、DMO_MEDIA_TYPE 構造体の pbFormat メンバが指すフォーマット ブロックを解放する。
1 つのメディア タイプ構造体のメンバを別のメディア タイプ構造体にコピーする。
構文
HRESULT MoCopyMediaType( DMO_MEDIA_TYPE *pmtDest, const DMO_MEDIA_TYPE *pmtSrc );
パラメータ
- pmtDest
- コピー先の DMO_MEDIA_TYPE 構造体を指すポインタ。呼び出し元はこの構造体を割り当てる必要があるが、初期化してはいけない。
- pmtSrc
- コピー元の DMO_MEDIA_TYPE 構造体を指すポインタ。
戻り値
HRESULT 値を返す。以下の値をとる。
S_OK 成功 E_OUTOFMEMORY メモリ不足 E_POINTER NULL ポインタ引数
注意
この関数は、*pmtSrc のすべてのメンバを *pmtDest にコピーし、フォーマット ブロックをコピーする。
呼び出し元は、MoFreeMediaType 関数を呼び出すことによってコピー先メディア タイプを解放する必要がある。
新しいメディア タイプ構造体を割り当てる。
構文
HRESULT MoCreateMediaType( DMO_MEDIA_TYPE **ppmt, DWORD cbFormat );
パラメータ
- ppmt
- 割り当てられた構造体を受け取る DMO_MEDIA_TYPE 構造体を指すポインタのアドレス。
- cbFormat
- フォーマット ブロックに割り当てるバイトの数。0 も指定できる。
戻り値
HRESULT 値を返す。以下の値をとる。
S_OK 成功 E_OUTOFMEMORY メモリ不足 E_POINTER NULL ポインタ引数
注意
この関数は新しい DMO_MEDIA_TYPE 構造体を割り当てて、MoInitMediaType 関数を呼び出すことによって、その構造体を初期化する。
呼び出し元は、MoDeleteMediaType 関数を呼び出すことによってメディア タイプ構造体を削除する必要がある。
前に割り当てられたメディア タイプ構造体を削除する。
構文
HRESULT MoDeleteMediaType( DMO_MEDIA_TYPE *pmt );
パラメータ
- pmt
- 初期化された DMO_MEDIA_TYPE 構造体を指すポインタ。
戻り値
HRESULT 値を返す。以下の値をとる。
S_OK 成功 E_POINTER NULL ポインタ引数
注意
この関数は、MoFreeMediaType を呼び出すことによって、メディア タイプ構造体の割り当て済みのメンバを解放する。次に、この関数は、メディア タイプ構造体そのものを解放する。
メディア タイプ構造体を複製する。
構文
HRESULT MoDuplicateMediaType( DMO_MEDIA_TYPE **ppmtDest, const DMO_MEDIA_TYPE *pmtSrc );
パラメータ
- ppmtDest
- 複製された構造体を受け取る DMO_MEDIA_TYPE 構造体を指すポインタのアドレス。
- pmtSrc
- 複製するメディア タイプ構造体を指すポインタ。
戻り値
HRESULT 値を返す。以下の値をとる。
S_OK 成功 E_OUTOFMEMORY メモリ不足 E_POINTER NULL ポインタ引数
注意
このメソッドを実行することは、MoCreateMediaType と MoCopyMediaType を呼び出すことに等しい。
呼び出し元は、MoDeleteMediaType 関数を呼び出すことによって、返されたメディア タイプ構造体を削除する必要がある。