Compartilhar via


Método IPropertySetter::LoadXML

[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.]

Observação

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

 

O LoadXML método carrega dados de propriedade expressos em XML (Extensible Markup Language).

Sintaxe

HRESULT LoadXML(
  [in] IUnknown *pxml
);

Parâmetros

pxml [in]

Ponteiro para a interface IUnknown de um elemento XML criado pelo analisador XML da Microsoft.

Retornar valor

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

Código de retorno Descrição
S_FALSE
Nenhum dado de propriedade.
S_OK
Êxito.
E_OUTOFMEMORY
Memória insuficiente.
VFW_E_INVALID_FILE_FORMAT
Formato inválido.

 

Comentários

Normalmente, os aplicativos não precisarão usar esse método. O DES o usa internamente para carregar propriedades de arquivos XTL.

Para usar esse método, crie um objeto IXMLDocument e use-o para analisar um arquivo XML. Em seguida, use o objeto IXMLDocument para recuperar objetos IXMLElement . Se o objeto tiver propriedades, você poderá passar o ponteiro IXMLElement para o método LoadXML . O método carrega as propriedades no setter de propriedade.

Observação

As interfaces IXMLDocument e IXMLElement são implementadas no Microsoft XML Core Services (MSXML) versão 1.0, mas não são implementadas em versões mais recentes do MSXML.

 

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