Partilhar via


Usando o parâmetro de contexto

[A funcionalidade associada a esta página, Windows Media Format 11 SDK, é uma funcionalidade herdada. Foi substituído por Source Reader e Sink Writer. Source Reader e Sink Writer foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize o Leitor de Origem e o Gravador de Destino em vez do SDK do Windows Media Format 11 , sempre que 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 Windows Media Format usam 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, quando você chama IWMReader::Open, você pode passar um valor para pvContext. Quando o métodoIWMStatusCallback::OnStatus é chamado pelo objeto reader para notificar seu aplicativo de que o arquivo foi aberto, ele passará qualquer valor que você usou em sua chamada para Open como o parâmetro pvContext de OnStatus. Este parâmetro de contexto é fornecido para seu uso e você pode usá-lo da maneira que quiser.

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étodoIWMStatusCallback::OnStatus. Você pode usar pvContext para permitir que os diferentes objetos compartilhem uma implementação de "OnStatus" ao passar um valor diferente para pvContext na sua chamada original. Na implementação do OnStatus, você pode ramificar a lógica de manipulação de mensagens com base no valor de pvContext.

Usando os métodos de retorno de chamada