Qt Multimedia Windows

このページでは、Windows でQt Multimedia を使用する際の注意事項について説明します。

COMに関する注意事項

Qt Multimedia は Windows プラットフォームの COM API を使用します。このため、Qt Multimedia API にアクセスするスレッド上で COM を初期化する必要があります。Qt Multimedia API は必要に応じて自動的に COM を初期化しますが、Qt Multimedia API を呼び出す前に、アプリケーションの起動時にメインスレッドからQGuiApplication インスタンスを初期化することをお勧めします。これにより、どのスレッドからもQt Multimedia API が呼び出される前に、メインのシングル・スレッド・アパートメント（メイン STA）が初期化されます。これにより、他のすべてのアパートメントがシャットダウンするまで、メインSTAが初期化されないことも保証されます。

Qt Multimedia COMを必要とするAPIは、CoInitializeEx(nullptr, COINIT_APARTMENT_THREADED) を呼び出すことで、シングルスレッド・アパートメントとしてスレッドを初期化します。CoUninitialize は、スレッドが終了するまで呼び出されません。これはメイン・アプリケーション・スレッドにも当てはまり、CoUninitialize は静的変数の破棄中に呼び出されます。