DRVM_MAPPER_CONSOLEVOICECOM_GET関数

  • [アーティクル]

DRVM_MAPPER_CONSOLEVOICECOM_GET メッセージは、優先される音声通信デバイスのデバイス ID を取得します。

構文

DWORD  xxxMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

パラメーター

  • uDeviceID
    対象デバイスの ID を指定します。 適切な関数で使用するためにこの値をキャストする方法の詳細については、以下の「解説」セクションを参照してください。

  • uMsg
    呼び出し元は、xxxMessage を呼び出してこのデバイス メッセージを処理するときに、このパラメーターを DRVM_MAPPER_PREFERRED_GET に設定します。

  • dwParam1
    デバイス ID へのポインター。 このパラメーターは、関数が現在の優先される音声通信デバイスのデバイス ID を書き込む DWORD 変数を指します。 この関数は、優先される音声通信デバイスとして適格なデバイスがない場合、値 (-1) を書き込みます。

  • dwParam2
    状態フラグへのポインター。 このパラメーターは、関数がデバイス ステータス フラグを書き込む DWORD 変数を指します。 現在定義されているフラグ ビットは 1 つだけです (DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY)。 詳細については、「解説」を参照してください。

戻り値

xxxMessage 関数は、メッセージが正常に処理された場合、MMSYSERR_NOERROR を返します。 成功しなかった場合は、適切なエラー コードを返します。

解説

このメッセージは、waveInMessage と waveOutMessage 関数に対してのみ有効です。 呼び出し元が DRVM_MAPPER_CONSOLEVOICECOM_GET メッセージを使用してこれら 2 つの関数を呼び出す場合、呼び出し元はデバイス ID を WAVE_MAPPER として指定し、この値を適切なハンドルの型にキャストする必要があります。 waveInMessage、waveOutMessage、midiInMessage、midiOutMessage、または mixerMessage 関数の場合、呼び出し元は、それぞれ HWAVEIN、HWAVEOUT、HMIDIIN、HMIDIOUT、または HMIXER 型のハンドルにデバイス ID をキャストする必要があります。 呼び出し元がこのパラメーターのデバイス ID ではなく有効なハンドルを指定した場合、関数は失敗し、エラー コード MMSYSERR_NOSUPPORT を返します。

システムはこのメッセージをインターセプトし、デバイス ドライバーにメッセージを送信することなく適切な値を返します。 システム インターセプト xxxMessage 関数の一般的な情報については、「システムインターセプトされたデバイス メッセージ」を参照してください。

このメッセージは、他のすべての音声機能に対してどのデバイスが優先されているかが判断される DRVM_MAPPER_PREFERRED_GET メッセージとは異なり、特に音声通信に対してどのデバイスが優先されているかを判断する方法を提供します。

たとえば、音声通信に優先される waveOut デバイスがヘッドセットのイヤーピースである場合に、他のすべてのオーディオ機能に優先される waveOut デバイスは、ステレオ スピーカーのセットである可能性があります。

dwParam2 が指す DWORD の場所に DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY フラグ ビットが設定されている場合、waveIn および waveOut API は現在の優先される音声通信デバイスのみを使用し、優先デバイスが使用できない場合には他の使用可能なデバイスの検索を行いません。 waveInMessage または waveOutMessage 呼び出しによって出力されるフラグは、waveInMessage と waveOutMessage のどちらに対して呼び出しが行われるかに関係なく、waveIn API と waveOut API の両方の優先される音声通信デバイスに適用されます。 詳細については、「優先される音声通信デバイス ID」を参照してください。

要件

対象プラットフォーム

 デスクトップ

バージョン

Microsoft Windows Me および Windows 2000 以降のオペレーティング システムでサポートされます。

ヘッダー

 Mmddk.h (Mmddk.h を含む)

関連項目

DRVM_MAPPER_PREFERRED_GET

midiInMessage

midiOutMessage

mixerMessage

推奨される音声通信デバイス ID

システムでインターセプトされるデバイス メッセージ

waveInMessage

waveOutMessage