Microsoft DirectX 8.0

メディア タイプ ヘルパー関数

これらの関数は、DMO_MEDIA_TYPE 構造体を操作する。これらの関数は Dmort.h ファイルで宣言される。

MoInitMediaTypeメディア タイプ構造体を初期化する。
MoFreeMediaTypeメディア タイプ構造体の割り当て済みのメンバを解放する。
MoCopyMediaType1 つのメディア タイプ構造体のメンバを別のメディア タイプ構造体にコピーする。
MoCreateMediaType新しいメディア タイプ構造体を割り当てる。
MoDeleteMediaType前に割り当てられたメディア タイプ構造体を削除する。
MoDuplicateMediaTypeメディア タイプ構造体を複製する。

MoInitMediaType

DMO 登録関数

メディア タイプ構造体を初期化する。

構文

HRESULT MoInitMediaType(
    DMO_MEDIA_TYPE *pmt, 
    DWORD cbFormat
);

パラメータ

pmt
呼び出し元によって割り当てられており、初期化されていない DMO_MEDIA_TYPE 構造体を指すポインタ。
cbFormat
フォーマット ブロックに割り当てるバイトの数。0 も指定できる。

戻り値

HRESULT 値を返す。以下の値をとる。

S_OK成功
E_OUTOFMEMORYメモリ不足
E_POINTERNULL ポインタ引数

注意

この関数はフォーマット ブロックを割り当てて、DMO_MEDIA_TYPE 構造体の cbFormat メンバと pbFormat メンバを設定する。

呼び出し元は、MoFreeMediaType 関数を呼び出すことによってメディア タイプを解放する必要がある。

MoFreeMediaType

DMO 登録関数

メディア タイプ構造体の割り当て済みのメンバを解放する。

構文

HRESULT MoFreeMediaType(
    DMO_MEDIA_TYPE *pmt
);

パラメータ

pmt
初期化された DMO_MEDIA_TYPE 構造体を指すポインタ。

戻り値

HRESULT 値を返す。以下の値をとる。

S_OK成功
E_POINTERNULL ポインタ引数

注意

この関数は、DMO_MEDIA_TYPE 構造体の pbFormat メンバが指すフォーマット ブロックを解放する。

MoCopyMediaType

DMO 登録関数

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_POINTERNULL ポインタ引数

注意

この関数は、*pmtSrc のすべてのメンバを *pmtDest にコピーし、フォーマット ブロックをコピーする。

呼び出し元は、MoFreeMediaType 関数を呼び出すことによってコピー先メディア タイプを解放する必要がある。

MoCreateMediaType

DMO 登録関数

新しいメディア タイプ構造体を割り当てる。

構文

HRESULT MoCreateMediaType(
    DMO_MEDIA_TYPE **ppmt, 
    DWORD cbFormat
);

パラメータ

ppmt
割り当てられた構造体を受け取る DMO_MEDIA_TYPE 構造体を指すポインタのアドレス。
cbFormat
フォーマット ブロックに割り当てるバイトの数。0 も指定できる。

戻り値

HRESULT 値を返す。以下の値をとる。

S_OK成功
E_OUTOFMEMORYメモリ不足
E_POINTERNULL ポインタ引数

注意

この関数は新しい DMO_MEDIA_TYPE 構造体を割り当てて、MoInitMediaType 関数を呼び出すことによって、その構造体を初期化する。

呼び出し元は、MoDeleteMediaType 関数を呼び出すことによってメディア タイプ構造体を削除する必要がある。

MoDeleteMediaType

DMO 登録関数

前に割り当てられたメディア タイプ構造体を削除する。

構文

HRESULT MoDeleteMediaType(
    DMO_MEDIA_TYPE *pmt
);

パラメータ

pmt
初期化された DMO_MEDIA_TYPE 構造体を指すポインタ。

戻り値

HRESULT 値を返す。以下の値をとる。

S_OK成功
E_POINTERNULL ポインタ引数

注意

この関数は、MoFreeMediaType を呼び出すことによって、メディア タイプ構造体の割り当て済みのメンバを解放する。次に、この関数は、メディア タイプ構造体そのものを解放する。

MoDuplicateMediaType

DMO 登録関数

メディア タイプ構造体を複製する。

構文

HRESULT MoDuplicateMediaType(
    DMO_MEDIA_TYPE **ppmtDest, 
    const DMO_MEDIA_TYPE *pmtSrc
);

パラメータ

ppmtDest
複製された構造体を受け取る DMO_MEDIA_TYPE 構造体を指すポインタのアドレス。
pmtSrc
複製するメディア タイプ構造体を指すポインタ。

戻り値

HRESULT 値を返す。以下の値をとる。

S_OK成功
E_OUTOFMEMORYメモリ不足
E_POINTERNULL ポインタ引数

注意

このメソッドを実行することは、MoCreateMediaTypeMoCopyMediaType を呼び出すことに等しい。

呼び出し元は、MoDeleteMediaType 関数を呼び出すことによって、返されたメディア タイプ構造体を削除する必要がある。