Método IPersistMediaPropertyBag::Load (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 Load método carrega propriedades do recipiente de propriedades de mídia no filtro.

Sintaxe

HRESULT Load(
  [in] IMediaPropertyBag *pPropBag,
  [in] IErrorLog         *pErrorLog
);

Parâmetros

[in] pPropBag

Ponteiro para a interface IMediaPropertyBag de um recipiente de propriedades de mídia criado pelo chamador.

[in] pErrorLog

Reservado. Defina o valor como NULL.

Retornar valor

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

Comentários

Chame esse método no filtro AVI Mux para gravar as propriedades no fluxo AVI. Chame o método quando o filtro for interrompido, antes de executar o grafo de filtro para criar o arquivo. Quando o grafo é executado, o filtro grava as partes INFO no cabeçalho AVI.

O exemplo de código a seguir adiciona uma parte INFO de IART (nome do autor) a um arquivo:

IPersistMediaPropertyBag *pPersist = NULL; IMediaPropertyBag *pBag = NULL; VALOR VARIANT;
Consulte o filtro AVI Mux para IPersistMediaPropertyBag (não mostrado).
CoCreateInstance(CLSID_MediaPropertyBag, NULL, CLSCTX_INPROC, IID_IMediaPropertyBag, (LPVOID *)&pBag);
val.vt = VT_BSTR;
val.bstrVal = SysAllocString(OLESTR("Author Name"));
pBag->Write(OLESTR("INFO/IART"), &val);
pPersist->Load(pBag, NULL);
VariantClear(&val);

Requisitos

Confira também

Códigos de erro e êxito

IPersistMediaPropertyBag Interface