Uso del callback OnStatus
[La funzionalità associata a questa pagina, Windows Media Format 11 SDK, è una funzionalità legacy. È stata sostituita da Lettore di origine e Writer sink. Lettore di origine e Writer sink sono stati ottimizzati per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi Lettore di origine e Writer sink anziché Windows Media Format 11 SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il metodo di callback IWMStatusCallback::OnStatus viene chiamato da diversi oggetti in Windows Media Format SDK. OnStatus riceve messaggi che rappresentano modifiche nello stato delle operazioni sdk.
Per usare il metodo di callback OnStatus , è necessario implementare una classe nell'applicazione che eredita dall'interfaccia IWMStatusCallback . Includere il codice per la versione di OnStatus nella classe. Alcuni esempi di implementazioni di OnStatus sono disponibili negli esempi inclusi in questo SDK. Per altre informazioni sugli esempi, vedere Applicazioni di esempio.
È necessario associare l'implementazione del callback dello stato a vari oggetti di Windows Media Format SDK. Ogni oggetto ha un modo diverso per rendere questa associazione. Per un elenco dei metodi che associano oggetti specifici, vedere la pagina di riferimento IWMStatusCallback .
I messaggi di stato che possono essere ricevuti da OnStatus sono definiti nel tipo di enumerazione WMT_STATUS .
È possibile scegliere i messaggi da trappolare e quali ignorare. Tuttavia, la risposta a alcuni messaggi di stato è necessaria per determinate funzionalità. Ad esempio, quando si usa il lettore asincrono, il metodo IWMReader::Open apre un file in modo asincrono. L'unico modo per indicare quando il file è stato aperto è quello di intrappolare il messaggio di MWT_OPENED. In genere, i messaggi che si rispondono sono notifiche del completamento delle attività asincrone.
Argomenti correlati