Método IWMCodecProps::GetCodecProp (wmcodecdsp.h)

Artigo
08/28/2023

Recupera uma propriedade codec específica para um formato de saída.

Sintaxe

HRESULT GetCodecProp(
  [in]      DWORD             dwFormat,
  [in]      LPCWSTR           pszName,
  [out]     WMT_PROP_DATATYPE *pType,
  [out]     BYTE              *pValue,
  [in, out] DWORD             *pdwSize
);

Parâmetros

[in] dwFormat

O formato de saída ao qual a propriedade se aplica. Defina esse valor como o valor FOURCC do formato de vídeo desejado.

[in] pszName

Cadeia de caracteres largos e terminada em nulo que contém o nome da propriedade. As propriedades listadas na tabela a seguir têm suporte apenas por meio da interface IWMCodecProps.

Constante de nome da propriedade	Significado
g_wszWMCPCodecName	Recupera o nome do codec associado ao formato (ou FOURCC). Essa é uma alternativa à interface IWMCodecStrings .
g_wszWMCPSupportedVBRModes	Recupera os modos de codificação compatíveis com o codec. O valor retornado contém um ou mais dos seguintes sinalizadores: WM_CODEC_ONEPASS_CBR WM_CODEC_ONEPASS_VBR WM_CODEC_TWOPASS_CBR WM_CODEC_TWOPASS_VBR_UNCONSTRAINED WM_CODEC_TWOPASS_VBR_PEAKCONSTRAINED

[out] pType

Endereço de uma variável que recebe o tipo de dados do valor da propriedade.

[out] pValue

Endereço do buffer de bytes que recebe o valor da propriedade.

[in, out] pdwSize

Ponteiro para o tamanho do buffer de valor, em bytes. Se pValue for NULL, o método definirá esse valor como o tamanho necessário.

Valor retornado

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.

Requisitos


Cliente mínimo com suporte	Windows XP [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	wmcodecdsp.h

Confira também

IWMCodecProps Interface

Compartilhar via