break コマンド

break コマンドは、"wait" フラグを使用して呼び出されたコマンドを中止するキーを指定します。このコマンドは MCI システムコマンドです。MCI によって直接解釈されます。

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

_stprintf_s(
  lpszCommand, 
  TEXT("break %s %s %s"), 
  lpszDeviceID, 
  lpszVirtKey, 
  lpszFlags
);

パラメーター

lpszDeviceID

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

lpszVirtKey

次のいずれかのフラグ。

値	説明
仮想キーコードの場合	"wait" フラグを使用して開始されたコマンドを中止するキーを指定します。
オフ	現在のブレークキーを無効にします。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。デジタルビデオおよび VCR デバイスの場合は、"テスト" を指定することもできます。これらのフラグの詳細については、「待機、通知、テストフラグ」を参照してください。

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

中断キーが有効になっており、ユーザーが lpszVirtKey パラメーターで指定された仮想キーコードによって識別されるキーを押すと、デバイスはアプリケーションに制御を返します。可能であれば、コマンドは実行を続行します。

次のコマンドは、"mysound" デバイスの中断キーとして F2 を設定します。

break mysound on 113

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]