Microsoft DirectX 8.0 |
IDirectDrawMediaSample インターフェイスは、IMediaSample もサポートするオブジェクトによってサポートされる。この種のサンプルの "バッファ" は、Microsoft® DirectDraw® サーフェスである。この種のサンプルは、オーバーレイ ミキサーとアップストリーム デコーダ フィルタとの接続用の IDirectDrawMediaSampleAllocator によって割り当てられる。 このインターフェイスを利用すると、デコーダ フィルタは、サーフェスのロックを解除すると同時にサーフェスを保持できるため、ほかのコンポーネントもサーフェスにアクセスできる。
vtable 順のメソッド
IUnknown メソッド 説明 QueryInterface サポートされているインターフェイスへのポインタを取得する。 AddRef 参照カウントをインクリメントする。 Release 参照カウントをデクリメントする。 IDirectDrawMediaSample メソッド 説明 GetSurfaceAndReleaseLock サンプルが表すサーフェスを取得し、ロックを解除する。 LockMediaSamplePointer サンプルが表すサーフェスをロックする。
サンプルが表すサーフェスを取得し、ロックを解除する。
構文
HRESULT GetSurfaceAndReleaseLock( IDirectDrawSurface **ppDirectDrawSurface RECT *pRect );
パラメータ
- ppDirectDrawSurface
- [out] サンプルの IDirectDrawSurface インターフェイスへのポインタのアドレス。
- pRect
- [out] サンプルが表すサーフェスの部分を定義する矩形のアドレスを受け取る変数へのポインタ。
戻り値
HRESULT 値を返す。
注意
呼び出し側は、このインターフェイスのオーバーレイ ミキサー フィルタの実装を呼び出す場合を除き、返されたサーフェス ポインタを解放する必要がある。
サンプルが表すサーフェスをロックする。
構文
HRESULT LockMediaSamplePointer(void);
戻り値
HRESULT 値を返す。
注意
このメソッドは、必ず GetSurfaceAndReleaseLock を呼び出した後に呼び出すこと。