DRV_QUERYMAPPABLE関数

DRV_QUERYMAPPABLE メッセージは、指定したデバイスをマッパーが使用できるかどうかを照会します。

構文

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

パラメーター

  • uDeviceID
    対象デバイスの ID を指定します。

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

  • dwParam1
    未使用。 このパラメーターを 0 に設定します。

  • dwParam2
    未使用。 このパラメーターを 0 に設定します。

戻り値

xxxMessage 関数は、デバイスがマップ可能な場合、MMSYSERR_NOERROR を返します。 成功しなかった場合は、適切なエラー コードを返します。

解説

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

アプリケーション プログラムが特定のオーディオ デバイスではなくマッパーを開くと、システムはアプリケーションと使用可能なデバイスの間にマッパーを挿入します。 マッパーは、アプリケーションの要件を利用可能なデバイスの 1 つにマッピングすることにより、適切なデバイスを選択します。 マッパーの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

要件

対象プラットフォーム

デスクトップ

バージョン

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

ヘッダー

Mmddk.h (Mmddk.h を含む)

関連項目

auxOutMessage

midiInMessage

midiOutMessage

mixerMessage

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

waveInMessage

waveOutMessage