IOverlay::GetClipList メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは GetClipList クリッピング リストを取得します。

構文

HRESULT GetClipList(
  [out] RECT    *pSourceRect,
  [in]  RECT    *pDestinationRect,
  [out] RGNDATA **ppRgnData
);

パラメーター

[out] pSourceRect

境界クライアントの四角形へのポインター。

[in] pDestinationRect

移動先の四角形へのポインター。

[out] ppRgnData

ヘッダーへのポインターのアドレスと、クリッピングを記述するデータ。 成功した場合は、 CoTaskMemFree を呼び出して、割り当てられたメモリを解放します。

戻り値

成功した場合はS_OKを返します。 メソッドが失敗した場合は、 HRESULT エラー コードが返されます。

注釈

IOverlay 実装では、長さが異なる可能性があるため、クリッピング四角形のメモリが割り当てられます。 このメソッドを呼び出すフィルターは、メモリが終了したときに ( CoTaskMemFree を使用して) メモリを解放する必要があります。

要件

こちらもご覧ください

エラーコードと成功コード

IOverlay インターフェイス