Share via

OnStatus コールバックの使用

  • [アーティクル]

[このページに関連付けられている機能である Windows Media Format 11 SDK は、レガシ機能です。 これは、ソース リーダーとシンク ライターによって置き換えられます。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

IWMStatusCallback::OnStatus コールバック メソッドは、Windows Media Format SDK の複数のオブジェクトによって呼び出されます。 OnStatus は、SDK 操作の状態の変化を表すメッセージを受信します。

OnStatus コールバック メソッドを使用するには、IWMStatusCallback インターフェイスから継承するクラスをアプリケーションに実装する必要があります。 クラスに OnStatus のバージョンのコードを含めます。 OnStatus 実装のいくつかの例については、この SDK に含まれているサンプルを参照してください。 サンプルの詳細については、「 サンプル アプリケーション」を参照してください。

状態コールバックの実装を Windows Media Format SDK のさまざまなオブジェクトに関連付ける必要があります。 各オブジェクトには、この関連付けの方法が異なります。 特定のオブジェクトを関連付けるメソッドの一覧については、 IWMStatusCallback のリファレンス ページを参照してください。

OnStatus で受信できるステータス メッセージは、WMT_STATUS列挙型で定義されます。

トラップするメッセージと無視するメッセージを選択できます。 ただし、特定の機能では、一部のステータス メッセージへの応答が必要です。 たとえば、非同期リーダーを使用する場合、 IWMReader::Open メソッドはファイルを非同期的に開きます。 ファイルがいつ開かれたかを確認する唯一の方法は、MWT_OPENEDメッセージをトラップすることです。 通常、応答するメッセージは非同期タスクの完了の通知です。

コールバック メソッドの使用