Metodo IMFCaptureSource::AddEffect (mfcaptureengine.h)

Aggiunge un effetto a un flusso di acquisizione.

Sintassi

HRESULT AddEffect(
  [in] DWORD    dwSourceStreamIndex,
  [in] IUnknown *pUnknown
);

Parametri

[in] dwSourceStreamIndex

Flusso di acquisizione. Il valore può essere uno dei seguenti.

Valore Significato
0-0xFFFFFFFB
Indice in base zero di un flusso. Per ottenere il numero di flussi, chiamare IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
Primo flusso di immagini.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
Primo flusso video.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
Primo flusso audio.

[in] pUnknown

Puntatore a uno dei seguenti:

  • Trasformazione MFT (Media Foundation) che espone l'interfaccia IMFTransform .
  • Oggetto attivazione MFT che espone l'interfaccia IMFActivate .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Operazione completata.
MF_E_INVALIDMEDIATYPE
Non è stato trovato alcun tipo di supporto compatibile.
MF_E_INVALIDSTREAMNUMBER
Il parametro dwSourceStreamIndex non è valido.

Commenti

L'effetto deve essere implementato come MFT (Media Foundation Transform ). Il parametro pUnknown può puntare a un'istanza di MFT o a un oggetto di attivazione per MFT. Per altre informazioni, vedere Oggetti attivazione.

L'effetto viene applicato al flusso prima che i dati raggiungano i sink di acquisizione.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfcaptureengine.h

Vedi anche

IMFCaptureSource