Método IMFASFStreamConfig::GetPayloadExtension (wmcontainer.h)

Artigo
03/13/2024

Recupera informações sobre uma extensão de conteúdo existente.

Sintaxe

HRESULT GetPayloadExtension(
  [in]      WORD  wPayloadExtensionNumber,
  [out]     GUID  *pguidExtensionSystemID,
  [out]     WORD  *pcbExtensionDataSize,
  [out]     BYTE  *pbExtensionSystemInfo,
  [in, out] DWORD *pcbExtensionSystemInfo
);

Parâmetros

[in] wPayloadExtensionNumber

O índice de extensão de conteúdo. Os índices válidos variam de 0 a um a menos do que o número de extensões obtidas chamando IMFASFStreamConfig::GetPayloadExtensionCount.

[out] pguidExtensionSystemID

Recebe um GUID que identifica a extensão de conteúdo. Para obter uma lista de extensões de conteúdo predefinidas, consulte GUIDs de extensão de conteúdo ASF. Os aplicativos também podem definir extensões de conteúdo personalizadas.

[out] pcbExtensionDataSize

Recebe o número de bytes adicionados a cada amostra para a extensão.

[out] pbExtensionSystemInfo

Ponteiro para um buffer que recebe informações sobre esse sistema de extensão. Essas informações são as mesmas para todos os exemplos e são armazenadas no cabeçalho de conteúdo (não em cada exemplo). Este parâmetro pode ser NULL. Para localizar o tamanho necessário do buffer, defina esse parâmetro como NULL; o tamanho é retornado em pcbExtensionSystemInfo.

[in, out] pcbExtensionSystemInfo

Na entrada, especifica o tamanho do buffer apontado por pbExtensionSystemInfo. Na saída, recebe o tamanho necessário do buffer pbExtensionSystemInfo em bytes.

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.
E_INVALIDARG	Argumento inválido.
MF_E_BUFFERTOOSMALL	O buffer especificado em pbExtensionSystemInfo é muito pequeno.
MF_E_INVALIDINDEX	O parâmetro wPayloadExtensionNumber está fora do intervalo.

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	wmcontainer.h
Biblioteca	Mfuuid.lib

Confira também

IMFASFStreamConfig

IMFASFStreamConfig::AddPayloadExtension

IMFASFStreamConfig::GetPayloadExtensionCount

Compartilhar via