Compartilhar via


Usando o retorno de chamada onStatus

[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 de retorno de chamada IWMStatusCallback::OnStatus é chamado por vários objetos no SDK do Formato de Mídia do Windows. O OnStatus recebe mensagens que representam alterações no status de operações do SDK.

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

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

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

Você pode escolher quais mensagens interceptar e quais ignorar. No entanto, responder a alguns status mensagens é 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 dizer quando o arquivo foi aberto é interceptar 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