Microsoft DirectX 8.0

IDirectDrawMediaSample インターフェイス

IDirectDrawMediaSample インターフェイスは、IMediaSample もサポートするオブジェクトによってサポートされる。この種のサンプルの "バッファ" は、Microsoft® DirectDraw® サーフェスである。この種のサンプルは、オーバーレイ ミキサーとアップストリーム デコーダ フィルタとの接続用の IDirectDrawMediaSampleAllocator によって割り当てられる。 このインターフェイスを利用すると、デコーダ フィルタは、サーフェスのロックを解除すると同時にサーフェスを保持できるため、ほかのコンポーネントもサーフェスにアクセスできる。

vtable 順のメソッド

IUnknown メソッド説明
QueryInterface サポートされているインターフェイスへのポインタを取得する。
AddRef 参照カウントをインクリメントする。
Release 参照カウントをデクリメントする。
IDirectDrawMediaSample メソッド説明
GetSurfaceAndReleaseLock サンプルが表すサーフェスを取得し、ロックを解除する。
LockMediaSamplePointer サンプルが表すサーフェスをロックする。

IDirectDrawMediaSample::GetSurfaceAndReleaseLock

IDirectDrawMediaSample Interface

サンプルが表すサーフェスを取得し、ロックを解除する。

構文

HRESULT GetSurfaceAndReleaseLock(
    IDirectDrawSurface **ppDirectDrawSurface
    RECT *pRect
);

パラメータ

ppDirectDrawSurface
[out] サンプルの IDirectDrawSurface インターフェイスへのポインタのアドレス。
pRect
[out] サンプルが表すサーフェスの部分を定義する矩形のアドレスを受け取る変数へのポインタ。

戻り値

HRESULT 値を返す。

注意

呼び出し側は、このインターフェイスのオーバーレイ ミキサー フィルタの実装を呼び出す場合を除き、返されたサーフェス ポインタを解放する必要がある。

IDirectDrawMediaSample::LockMediaSamplePointer

IDirectDrawMediaSample インターフェイス

サンプルが表すサーフェスをロックする。

構文

HRESULT LockMediaSamplePointer(void);

戻り値

HRESULT 値を返す。

注意

このメソッドは、必ず GetSurfaceAndReleaseLock を呼び出した後に呼び出すこと。