共用方式為

DRV_QUERYDEVICEINTERFACE函式

  • 發行項

DRV_QUERYDEVICEINTERFACE訊息會查詢 waveIn、waveOut、midiIn、midiOut 或混音器裝置的裝置介面名稱。

語法

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

參數

  • uDeviceID
    指定目標裝置的識別碼。

  • uMsg
    呼叫端會在呼叫 xxxMessage 來處理此裝置訊息時，將此參數設定為 DRV_QUERYDEVICEINTERFACE。

  • dwParam1
    呼叫端配置的緩衝區指標，函式會將包含裝置介面名稱的 Null 終止 Unicode 字串寫入其中。 如果裝置沒有裝置介面，則字串長度為零。

  • dwParam2
    以位元組為單位指定緩衝區大小。 這是函式的輸入參數。 呼叫端應該指定大於或等於 DRV_QUERYDEVICEINTERFACESIZE 訊息所擷取的緩衝區大小。

傳回值

如果成功處理訊息， xxxMessage 函式會傳回MMSYSERR_NOERROR。 否則，它會傳回適當的錯誤碼。

備註

Windows Me 和 Windows 2000 和更新版本支援DRV_QUERYDEVICEINTERFACE訊息。 此訊息僅適用於 waveInMessage、waveOutMessage、midiInMessage、midiOutMessage 和混合器Message 函式。 系統會攔截此訊息，並傳回適當的值，而不會將訊息傳送至設備驅動器。 如需系統攔截 xxxMessage 函式的一般資訊，請參閱 系統攔截的裝置訊息。

下列兩個訊息常數會一起使用，以取得裝置介面名稱：

  • DRV_QUERYDEVICEINTERFACESIZE

  • DRV_QUERYDEVICEINTERFACE

第一則訊息會取得包含裝置介面名稱之字串所需的緩衝區位元組大小。 第二則訊息會擷取所需大小的緩衝區中的名稱字串。

如需詳細資訊，請參閱 取得裝置介面名稱。

規格需求

目標平台

 桌面

標頭

 Mmddk.h (包含 Mmddk.h)

另請參閱

DRV_QUERYDEVICEINTERFACESIZE

midiInMessage

midiOutMessage

mixerMessage

系統攔截的裝置訊息

waveInMessage

waveOutMessage