Metodo IMFMediaEngine::TransferVideoFrame (mfmediaengine.h)

Copia il fotogramma video corrente in una superficie DXGI o una bitmap WIC.

Sintassi

HRESULT TransferVideoFrame(
  [in] IUnknown                    *pDstSurf,
  [in] const MFVideoNormalizedRect *pSrc,
  [in] const RECT                  *pDst,
  [in] const MFARGB                *pBorderClr
);

Parametri

[in] pDstSurf

Puntatore all'interfaccia IUnknown della superficie di destinazione.

[in] pSrc

Puntatore a una struttura MFVideoNormalizedRect che specifica il rettangolo di origine.

[in] pDst

Puntatore a una struttura RECT che specifica il rettangolo di destinazione.

[in] pBorderClr

Puntatore a una struttura MFARGB che specifica il colore del bordo.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

In modalità server frame chiamare questo metodo per far blittare il fotogramma video a una superficie DXGI o WIC. L'applicazione può chiamare questo metodo in qualsiasi momento dopo che il motore multimediale carica una risorsa video. In genere, tuttavia, l'applicazione chiama IMFMediaEngine::OnVideoStreamTick per prima cosa, per determinare se è disponibile un nuovo frame. Se OnVideoStreamTick restituisce S_OK, l'applicazione chiama TransferVideoFrame.

Il motore multimediale ridimensiona e le letterebox il video per adattarsi al rettangolo di destinazione. Riempie l'area della casella di lettere con il colore del bordo.

Per il contenuto protetto, chiamare il metodo IMFMediaEngineProtectedContent::TransferVideoFrame anziché questo metodo.

Requisiti

Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mfmediaengine.h

Vedi anche

IMFMediaEngine