signal コマンド

signal コマンドは、アプリケーションに MM_MCISIGNAL メッセージを送信することによって、ワークスペース内の指定された位置を識別します。 デジタル ビデオ デバイスはこのコマンドを認識します。 MCIAVI では、一度に 1 つのアクティブ信号のみがサポートされます。

このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。

_stprintf_s(
  lpszCommand, 
  TEXT("signal %s %s %s"), 
  lpszDeviceID, 
  lpszSignalFlags, 
  lpszFlags
); 

パラメーター

lpszDeviceID

MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszSignalFlags

次のいずれかのフラグ。

値	説明
位置	シグナルを呼び出すフレームを指定します。
cancel	ワークスペースからシグナルを削除します。 "uservalue" フラグを使用して、個々のシグナルを指定します。 "cancel" を使用して "uservalue" フラグが指定されていない場合、デバイスはすべてのシグナルを取り消します。 "cancel" フラグは、"at"、"every"、および "return position" フラグと互換性がありません。
すべての 間隔	シグナルの期間を指定します。 間隔の値は、現在の時刻形式で指定されます。"at" 位置と共に使用すると、ワークスペース全体に信号が配置され、1 つのシグナル マークが位置に配置されます。 "at" フラグを指定しないと、ワークスペース全体にシグナルが配置され、現在の位置に 1 つのシグナルが配置されます。 このフラグを省略すると、"at" フラグで示される位置のみがマークされます。 間隔の値がデバイスでサポートされている最小頻度より小さい場合、その最小値が使用されます。
戻り位置	シグナリング メッセージの "uservalue" 識別子ではなく、デバイスが位置値を送信する必要があることを示します。 "uservalue" 識別子は、シグナル マークを取り消したり再定義したりするために引き続き使用できます。
uservalue id	シグナリング メッセージで報告される識別子を指定します。 この識別子は、このシグナル設定を参照するために他のシグナル コマンドと共に使用できる識別子として機能します。 省略すると、既定値は 0 になります。

lpszFlags

"wait"、"notify"、"test"、またはこれらの組み合わせを指定できます。 これらのフラグの詳細については、「 待機、通知、テスト フラグ」を参照してください。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説

コマンド完了メッセージの通知に使用されるウィンドウ ハンドルは、シグナリングにも使用されます。

要件

関連項目

Mci

MCI コマンド文字列

MM_MCISIGNAL