Método IMediaSample2::SetProperties (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 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.

Código de retorno Descrição
S_OK
 Êxito.
E_INVALIDARG
 Argumento inválido.
E_OUTOFMEMORY
 Memória insuficiente.
E_POINTER
 Argumento de ponteiro NULL.

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

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