Para implementar mensagens de leitor no retorno de chamada do 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 de 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 de 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.]
Para usar o leitor assíncrono para fornecer conteúdo de um arquivo ASF, você deve implementar um mínimo de dois métodos de retorno de chamada, IWMStatusCallback::OnStatus e IWMReaderCallback::OnSample. Esta seção descreve como implementar IWMStatusCallback::OnStatus para receber e responder a mensagens status enviadas pelo leitor. O OnStatus é usado por outros objetos no SDK de Formato de Mídia do Windows. Para obter informações gerais sobre o OnStatus, consulte Usando o retorno de chamada do OnStatus.
Ao usar o leitor assíncrono, você deve interceptar as seguintes mensagens em IWMStatusCallback::OnStatus.
| Mensagem de status | Descrição |
|---|---|
| WMT_OPENED | Enviado quando as operações de abertura de arquivo são concluídas. |
| WMT_CLOSED | Enviado quando as operações de fechamento de arquivo são concluídas. |
Você deve usar as mensagens status listadas acima para controlar a execução do aplicativo de leitura. Por exemplo, você deve aguardar até receber a mensagem WMT_OPENED para iniciar o leitor ou chamar outros métodos que exigem que o leitor tenha um arquivo pronto. Frequentemente, aplicativos criados com o leitor assíncrono usam um evento para sinalizar a conclusão de chamadas assíncronas e continuar com o processamento. Para obter mais informações sobre como usar eventos para sinalizar a conclusão de operações, consulte Usando eventos com chamadas assíncronas.
Muitas outras mensagens são enviadas ao OnStatus pelo objeto leitor para permitir que o aplicativo responda ao status de operações de leitura. Os possíveis valores de mensagem status são definidos no tipo de enumeração WMT_STATUS.
Tópicos relacionados