Partilhar via


Usando o Callback OnStatus

[A funcionalidade associada a esta página, Windows Media Format 11 SDK, é uma funcionalidade herdada. Foi substituído por Source Reader e Sink Writer. do 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.]

O IWMStatusCallback::OnStatus método de retorno de chamada é chamado por vários objetos no Windows Media Format SDK. OnStatus recebe mensagens que representam alterações no status das operações do SDK.

Para usar o método de retorno de chamada OnStatus, deve implementar uma classe na sua aplicação que herda da interface IWMStatusCallback. Inclua o código para sua versão do OnStatus na classe. Vários exemplos de implementações OnStatus podem ser encontrados nos exemplos incluídos com este SDK. Para obter mais informações sobre os exemplos, consulte Aplicativos de exemplo.

Você deve associar sua implementação do retorno de chamada de status a vários objetos do SDK do Windows Media Format. Cada objeto tem uma maneira diferente de fazer essa associação. Para ver uma lista dos métodos que associam objetos específicos, consulte a página de referência do IWMStatusCallback.

As mensagens de status que podem ser recebidas por OnStatus são definidas no tipo de enumeração WMT_STATUS.

Você pode escolher quais mensagens capturar e quais ignorar. No entanto, responder a algumas mensagens de status é necessário para determinados recursos. Por exemplo, ao usar o leitor assíncrono, o método IWMReader::Open abre um arquivo de forma assíncrona. A única maneira de saber quando o arquivo foi aberto é intercetar a mensagem MWT_OPENED. Normalmente, as mensagens às quais você responde são notificações da conclusão de tarefas assíncronas.

Usando os métodos de retorno de chamada