Compartilhar via


Método IVMRDeinterlaceControl::SetDeinterlaceMode (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método SetDeinterlaceMode define o modo de desinterlacing para o fluxo de vídeo especificado.

Sintaxe

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

Parâmetros

[in] dwStreamID

Índice do fluxo de vídeo a ser definido. Para definir todos os fluxos, use o valor 0xFFFFFFFF.

[in] lpDeinterlaceMode

Ponteiro para um GUID que especifica o modo de desinterlacagem. Para desativar a desinterlacagem, use o valor GUID_NULL.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes:

Código de retorno Descrição
E_INVALIDARG
Número de fluxo inválido.
E_POINTER
Argumento de ponteiro NULL.
S_OK
Êxito.
VFW_E_VMR_NOT_IN_MIXER_MODE
A VMR não está no modo de mixer.

Comentários

Se o aplicativo não especificar o modo, a VMR usará como padrão o primeiro modo relatado pelo driver. Em ambos os casos, se a VMR não puder usar o modo preferencial, ela voltará para outro modo, conforme especificado no método IVMRDeinterlaceControl::SetDeinterlacePrefs .

O método SetDeinterlaceMode é eficaz apenas para novas conexões feitas com a VMR. Alguns modos de desinterlacização exigem exemplos de referência adicionais; o número exato depende do modo . A VMR aloca superfícies para esses exemplos adicionais. O cliente deve definir o modo de desinterlace antes que as superfícies sejam alocadas. A alocação do Surface ocorre após qualquer uma das seguintes opções:

  • Fixar conexões, incluindo reconexões dinâmicas
  • Alterações de formato dinâmico (o filtro upstream chama IPin::ReceiveConnection para especificar um novo formato)
  • Alterações de resolução
  • Monitorar alterações

Requisitos

   
Cliente mínimo com suporte Windows XP com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IVMRDeinterlaceControl Interface

IVMRDeinterlaceControl::GetDeinterlaceMode

Usando o Renderizador de Combinação de Vídeo