Metodo IVMRDeinterlaceControl::SetDeinterlaceMode (strmif.h)

Articolo
07/28/2023

[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

Condividi tramite