MCI_BREAK コマンド

  • [アーティクル]

MCI_BREAK コマンドは、MCI デバイスのブレーク キーを設定します。 MCI では、デバイスに渡すのではなく、このコマンドを直接サポートしています。 どの MCI アプリケーションでも、このコマンドを使用できます。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_BREAK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_BREAK_PARMS) lpBreak
);

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

MCI_NOTIFY、MCI_WAIT、または、デジタル ビデオおよびビデオ カセット レコーダー (VCR) デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpBreak

MCI_ BREAK_PARMS構造体へのポインター。

戻り値

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

解説

待機操作を中断するには、ブレーク キーを複数回押す必要がある場合があります。 デバイスの待機が取り消された後にブレーク キーを押すと、中断がアプリケーションに送信される可能性があります。 アプリケーションに仮想キー コードに対してアクションが定義されている場合、誤って中断に応答する可能性があります。 たとえば、アクセラレータ キーにVK_CANCELを使用するアプリケーションは、待機が取り消された後に押された場合、既定の Ctrl + BREAK キーに応答できます。

次の追加フラグは、すべてのデバイスに適用されます。

MCI_BREAK_HWND

lpBreak によって識別される構造体の hwndBreak メンバーには、その MCI デバイスの中断検出を有効にするために現在のウィンドウである必要があるウィンドウ ハンドルが含まれています。 これは通常、アプリケーションのメイン ウィンドウです。 省略すると、MCI は現在のウィンドウのウィンドウ ハンドルをチェックしません。

MCI_BREAK_KEY

lpBreak によって識別される構造体の nVirtKey メンバーは 、ブレーク キーに使用される仮想キー コードを指定します。 既定では、MCI は中断キーとして Ctrl + BREAK を割り当てます。 MCI_BREAK_OFFが指定されていない場合は、このフラグが必要です。

MCI_BREAK_OFF

指定されたデバイスの既存のブレーク キーを無効にします。

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Mmsystem.h (Windows.h を含む)

関連項目

Mci

MCI コマンド