Compartilhar via

Método IMediaSample2::GetProperties (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 GetProperties método recupera as propriedades de um exemplo de mídia.

Sintaxe

HRESULT GetProperties(
  [in]  DWORD cbProperties,
  [out] BYTE  *pbProperties
);

Parâmetros

[in] cbProperties

Comprimento dos dados de propriedade a serem recuperados, em bytes.

[out] pbProperties

Ponteiro para um buffer de tamanho cbProperties.

Retornar valor

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

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Argumento de ponteiro NULL.

Comentários

Os dados recuperados estão em conformidade com o formato da estrutura AM_SAMPLE2_PROPERTIES . Você pode recuperar um subconjunto das propriedades de exemplo definindo cbProperties como um valor menor que o tamanho da estrutura AM_SAMPLE2_PROPERTIES .

Para eficiência, o membro pMediaType retornado em AM_SAMPLE2_PROPERTIES é um ponteiro para os dados armazenados no exemplo de mídia, não uma cópia desses dados. O ponteiro pode se tornar inválido depois que o exemplo for passado para outro filtro ou após a conclusão do método IMemInputPin::Receive do pino de entrada. Além disso, não libere o ponteiro nem exclua o tipo de mídia.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [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

IMediaSample2 Interface