Metodo IVMRDeinterlaceControl::SetDeinterlaceMode (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo SetDeinterlaceMode imposta la modalità di denterlacing per il flusso video specificato.

Sintassi

HRESULT SetDeinterlaceMode(
  [in] DWORD  dwStreamID,
  [in] LPGUID lpDeinterlaceMode
);

Parametri

[in] dwStreamID

Indice del flusso video da impostare. Per impostare tutti i flussi, usare il valore 0xFFFFFFFF.

[in] lpDeinterlaceMode

Puntatore a un GUID che specifica la modalità di denterlacing. Per disattivare l'inserimento dei dati, usare il valore GUID_NULL.

Valore restituito

Restituisce un valore HRESULT . I possibili valori sono i seguenti:

Codice restituito Descrizione
E_INVALIDARG
Numero di flusso non valido.
E_POINTER
Argomento puntatore NULL.
S_OK
Operazione completata.
VFW_E_VMR_NOT_IN_MIXER_MODE
VmR non è in modalità mixer.

Commenti

Se l'applicazione non specifica la modalità, per impostazione predefinita vmR viene restituita la prima modalità segnalata dal driver. In entrambi i casi, se vmR non può usare la modalità preferita, viene eseguito il fallback a un'altra modalità, come specificato nel metodo IVMRDeinterlaceControl::SetDeinterlacePrefs .

Il metodo SetDeinterlaceMode è valido solo per le nuove connessioni effettuate a VMR. Alcune modalità di denterlacing richiedono esempi di riferimento aggiuntivi; il numero esatto dipende dalla modalità . VmR alloca le superfici per questi esempi aggiuntivi. Il client deve impostare la modalità deinterlace prima che le superfici siano state allocate. L'allocazione della superficie si verifica dopo una delle operazioni seguenti:

  • Aggiungere connessioni, incluse le riconnessioni dinamiche
  • Modifiche al formato dinamico (il filtro upstream chiama IPin::ReceiveConnection per specificare un nuovo formato)
  • Modifiche alla risoluzione
  • Monitorare le modifiche

Requisiti

   
Client minimo supportato Windows XP con SP1 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IVMRDeinterlaceControl

IVMRDeinterlaceControl::GetDeinterlaceMode

Uso del renderer di missaggio video