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

Artigo
03/04/2024

Recupera uma propriedade de formato para um tipo de mídia de saída. Use esse método para obter informações sobre formatos de áudio enumerados.

Sintaxe

HRESULT GetFormatProp(
  [in]      DMO_MEDIA_TYPE    *pmt,
  [in]      LPCWSTR           pszName,
  [out]     WMT_PROP_DATATYPE *pType,
  [out]     BYTE              *pValue,
  [in, out] DWORD             *pdwSize
);

Parâmetros

[in] pmt

Ponteiro para o tipo de mídia de saída.

[in] pszName

Cadeia de caracteres largos 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_wszSpeechFormatCaps	Recupera os modos de fala disponíveis para o formato (usados somente pelo codec de Voz do Windows Media Audio 9). O valor contém sinalizadores idênticos aos valores usados para especificar o modo para MFPKEY_WMAVOICE_ENC_MusicSpeechClassMode.

Também há suporte para as propriedades na lista a seguir. Eles são usados com IPropertyBag para vídeo.

[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 para o tamanho necessário.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
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

MFPKEY_VBRENABLED

MFPKEY_VBRQUALITY

Compartilhar via