次の方法で共有

DRV_QUERYDEVICEINTERFACE関数

  • [アーティクル]

DRV_QUERYDEVICEINTERFACE メッセージは、waveIn、waveOut、midiIn、midiOut、またはミキサー デバイスのデバイス インターフェイス名を照会します。

構文

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

パラメーター

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

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

  • dwParam1
    関数がデバイス インターフェイス名を含む null で終わる Unicode 文字列を書き込む、呼び出し元によって割り当てられたバッファーへのポインター。 デバイスにデバイス インターフェイスがない場合、文字列の長さは 0 です。

  • dwParam2
    バッファー サイズをバイト単位で指定します。 これは関数への入力パラメーターです。 呼び出し元は、DRV_QUERYDEVICEINTERFACESIZE メッセージによって取得されたバッファー サイズ以上のサイズを指定する必要があります。

戻り値

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

解説

DRV_QUERYDEVICEINTERFACE メッセージは、Windows Me および Windows 2000 以降でサポートされています。 このメッセージは、waveInMessage、waveOutMessage、midiInMessage、midiOutMessage、mixerMessage 関数に対してのみ有効です。 システムはこのメッセージをインターセプトし、デバイス ドライバーにメッセージを送信することなく適切な値を返します。 システム インターセプト xxxMessage 関数の一般的な情報については、「システムインターセプトされたデバイス メッセージ」を参照してください。

デバイス インターフェイス名を取得するために、次の 2 つのメッセージ定数は一緒に使用されます。

  • DRV_QUERYDEVICEINTERFACESIZE

  • DRV_QUERYDEVICEINTERFACE

最初のメッセージは、デバイス インターフェイス名を含む文字列を保持するために必要なバッファーのサイズ (バイト単位) を取得します。 2 番目のメッセージは、必要なサイズのバッファー内の名前文字列を取得します。

詳細情報は、「デバイス インターフェイス名の取得」を参照してください。

要件

対象プラットフォーム

 デスクトップ

ヘッダー

 Mmddk.h (Mmddk.h を含む)

関連項目

DRV_QUERYDEVICEINTERFACESIZE

midiInMessage

midiOutMessage

mixerMessage

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

waveInMessage

waveOutMessage