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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 GetNumberOfDeinterlaceModes recupera os modos de desinterlacing disponíveis para a VMR para o formato de vídeo especificado.

Sintaxe

HRESULT GetNumberOfDeinterlaceModes(
  [in]      VMRVideoDesc *lpVideoDescription,
  [in, out] LPDWORD      lpdwNumDeinterlaceModes,
  [out]     LPGUID       lpDeinterlaceModes
);

Parâmetros

[in] lpVideoDescription

Ponteiro para uma estrutura VMRVideoDesc que descreve o vídeo.

[in, out] lpdwNumDeinterlaceModes

Ponteiro para um valor DWORD . Na entrada, esse valor especifica o tamanho da matriz fornecida em lpDeinterlaceModes. Na saída, ele recebe o número de GUIDs que o método copiou para a matriz.

[out] lpDeinterlaceModes

Endereço de uma matriz alocada pelo chamador. O método preenche a matriz com valores guid. Para determinar o tamanho da matriz necessária, defina esse parâmetro como NULL e marcar o valor retornado em lpdwNumDeinterlaceModes.

Retornar valor

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

Código de retorno	Descrição
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.
VFW_E_DDRAW_CAPS_NOT_SUITABLE	A cartão de vídeo não dá suporte à desinterlacização de hardware.

Comentários

Esse método retorna uma matriz de GUIDs, em que cada GUID representa um modo de desinterlacagem com suporte em hardware pelo driver de dispositivo gráfico. A matriz é classificada por qualidade, portanto, a primeira entrada representa a melhor qualidade, a segunda entrada representa a próxima melhor qualidade e assim por diante.

Todos os drivers são necessários para dar suporte ao seguinte modo:

GUID	Descrição
DXVA_DeinterlaceBobDevice	Modo Bob

 

Os drivers podem dar suporte a modos adicionais e devem definir seus próprios GUIDs para identificá-los. Para cada modo retornado, chame o método IVMRDeinterlaceControl::GetDeinterlaceModeCaps para obter informações sobre esse modo.

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

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