Método IMFVideoMediaType::GetVideoRepresentation (mfobjects.h)

[Essa API não tem suporte e pode ser alterada ou indisponível no futuro. Em vez disso, os aplicativos devem definir o atributo MF_MT_DEFAULT_STRIDE no tipo de mídia para especificar o passo da superfície e, em seguida, chamar IMFMediaType::GetRepresentation.]

Recupera uma representação alternativa do tipo de mídia.

Sintaxe

HRESULT GetVideoRepresentation(
  [in]  GUID   guidRepresentation,
  [out] LPVOID *ppvRepresentation,
  [in]  LONG   lStride
);

Parâmetros

[in] guidRepresentation

GUID que especifica a representação a ser recuperada. Para obter uma lista de valores, consulte IMFMediaType::GetRepresentation.

[out] ppvRepresentation

Recebe um ponteiro para uma estrutura que contém a representação. O método aloca a memória para a estrutura. O chamador deve liberar a memória chamando IMFMediaType::FreeRepresentation.

[in] lStride

Passo da superfície do vídeo, em bytes. Se o passo for desconhecido, defina esse valor como 0. Se o valor for 0, o método calculará o passo a partir da largura da imagem e assumirá que não há preenchimento.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Esse método é equivalente a IMFMediaType::GetRepresentation , mas inclui o parâmetro lStride .

Em vez de chamar esse método, os aplicativos devem definir o atributo MF_MT_DEFAULT_STRIDE no tipo de mídia para especificar o passo da superfície e, em seguida, chamar IMFMediaType::GetRepresentation.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfobjects.h (inclua Mfidl.h)
Biblioteca	Mfuuid.lib

Confira também

IMFVideoMediaType

Tipos de mídia