Share via

DRV_QUERYDEVICEINTERFACESIZE函式

  • 發行項

DRV_QUERYDEVICEINTERFACESIZE訊息會查詢保存裝置介面名稱所需的緩衝區大小。

語法

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

參數

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

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

  • dwParam1
    緩衝區大小的指標。 此參數指向 ULONG 變數，函式會以位元組為單位寫入所需的緩衝區大小。 此大小包含名稱字串終止 Null 的儲存空間。 如果裝置標識碼識別沒有裝置介面的裝置，則大小為零。

  • dwParam2
    未使用的。 將此參數設定為零。

傳回值

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

備註

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

此訊息所擷取的緩衝區大小會以位元組計數表示。 它會指定包含裝置介面名稱之 Null 終止 Unicode 字串所需的緩衝區大小。 呼叫端會配置指定大小的緩衝區，並使用 DRV_QUERYDEVICEINTERFACE 訊息來擷取裝置介面名稱字串。

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

規格需求

目標平台

 桌面

版本

Microsoft Windows Me 和 Windows 2000 和更新版本的操作系統支援。

標頭

 Mmddk.h (包含 Mmddk.h)

另請參閱

DRV_QUERYDEVICEINTERFACE

midiInMessage

midiOutMessage

mixerMessage

取得裝置介面名稱

系統攔截的裝置訊息

waveInMessage

waveOutMessage