Compartilhar via


Método IPropertySetter::SaveToBlob

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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.]

Observação

[Preterido. Essa API pode ser removida de versões futuras do Windows.]

 

O SaveToBlob método salva os dados da propriedade em um formato de persistência.

Sintaxe

HRESULT SaveToBlob(
  [out] LONG *pcSize,
  [out] BYTE **ppb
);

Parâmetros

pcSize [out]

Recebe o tamanho dos dados, em bytes.

ppb [out]

Recebe um ponteiro para uma matriz de bytes que recebe os dados.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O método aloca memória para a matriz de bytes. O chamador deve liberá-lo, usando a função CoTaskMemFree .

Todos os nomes e valores de propriedade são truncados para 40 caracteres de comprimento. Por esse motivo, XML é o formato de persistência preferencial. Consulte Interface IXml2Dex.

Observação

O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.

 

Observação

Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito Valor
parâmetro
Qedit.h
Biblioteca
Strmiids.lib

Confira também

IPropertySetter Interface

Códigos de erro e êxito