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

[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 método SetProperties define as propriedades de um exemplo de mídia.

Sintaxe

HRESULT SetProperties(
  [in] DWORD      cbProperties,
  [in] const BYTE *pbProperties
);

Parâmetros

[in] cbProperties

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

[in] pbProperties

Ponteiro para um buffer de tamanho cbProperties.

Retornar valor

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

Comentários

Os dados contidos em AM_SAMPLE2_PROPERTIES estrutura. Você pode especificar um subconjunto das propriedades de exemplo definindo cbProperties como um valor menor que o tamanho da estrutura AM_SAMPLE2_PROPERTIES .

A implementação padrão desse método não dá suporte à atualização AM_SAMPLE2_PROPERTIES estrutura. Se esses membros não forem iguais a zero, o método retornará E_INVALIDARG. Para modificar os dados contidos no buffer de memória do exemplo, chame IMediaSample::GetPointer.

Requisitos

Confira também

Códigos de erro e êxito

IMediaSample2 Interface