Compartilhar via


Usando o parâmetro context

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

Alguns dos retornos de chamada usados pelo SDK do Formato de Mídia do Windows recebem um parâmetro chamado pvContext. Os objetos de chamada passam o valor especificado no método que iniciou a ação assíncrona. Por exemplo, ao chamar IWMReader::Open, você pode passar um valor para pvContext. Quando o método IWMStatusCallback::OnStatus é chamado pelo objeto reader para notificar seu aplicativo de que o arquivo foi aberto, ele passará qualquer valor usado em sua chamada para Open como o parâmetro pvContext de OnStatus. Esse parâmetro de contexto é fornecido para seu uso e você pode usá-lo da maneira que desejar.

O parâmetro pvContext é usado com mais frequência quando vários objetos precisam compartilhar o mesmo retorno de chamada. Por exemplo, vários objetos usam o método IWMStatusCallback::OnStatus . Você pode usar pvContext para permitir que os diferentes objetos compartilhem uma implementação de OnStatus passando um valor diferente para pvContext em sua chamada original. Na implementação do OnStatus, você pode ramificar a lógica de tratamento de mensagens com base no valor de pvContext.

Usando os métodos de retorno de chamada