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) |