共用方式為

CBaseControlVideo.CopyImage 方法

  • 發行項

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

建立映射的記憶體複本。

語法

HRESULT CopyImage(
   IMediaSample    *pMediaSample,
   VIDEOINFOHEADER *pVideoInfo,
   LONG            *pBufferSize,
   BYTE            *pVideoImage,
   RECT            *pSourceRect
);

參數

pMediaSample

包含影片影像之範例的指標。

pVideoInfo

代表視訊影像之格式的指標。

pBufferSize

輸出緩衝區大小的指標。

pVideoImage

輸出緩衝區的指標。

pSourceRect

來源視訊矩形的指標。

傳回值

如果 pVideoImage 參數為 Null， pBufferSize 參數會填入輸出緩衝區儲存影像所需的位元組數目。 如果傳入的緩衝區太小，或成員函式無法配置足夠的記憶體，則成員函式會傳回E_OUTOFMEMORY。

備註

成員函式會從範例擷取影像，並將其複製到輸出緩衝區。 複製到輸出緩衝區的視訊區段會反映透過 IBasicVideo 介面設定的來源矩形 (，不過它不會反映目的地矩形) 。

規格需求

需求 值
標頭
Ctlutil.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CBaseControlVideo 類別