Compartilhar via


Método IConfigAsfWriter::ConfigureFilterUsingProfile

[O recurso associado a esta página, Windows Media Format 11 SDK, é um recurso herdado. Ele foi substituído por Leitor de Origem e Gravador de Coletor. O Leitor de Origem e o Gravador do Coletor foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o Leitor de Origem e o Gravador do Coletor em vez do SDK do Windows Media Format 11, 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 ConfigureFilterUsingProfile é a maneira recomendada de definir um perfil. Ele configura o filtro para gravar um arquivo ASF com base no perfil definido pelo aplicativo especificado.

Sintaxe

HRESULT ConfigureFilterUsingProfile(
  [in] IWMProfile *pProfile
);

Parâmetros

pProfile [in]

Ponteiro para a interface IWMProfile no perfil definido pelo aplicativo.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_POINTER
O ponteiro da interface IWMProfile não é válido.
VFW_E_WRONG_STATE
O grafo é interrompido.

Comentários

Se tiver êxito, esse método fará com que um evento EC_GRAPH_CHANGED seja enviado ao aplicativo. Use esse método para configurar o gravador com um perfil personalizado do Windows Media 9 Series que você criou (ou carregou de um arquivo .prx existente) usando os métodos do SDK do Formato de Mídia do Windows.

Confira também

IConfigAsfWriter Interface