共用方式為

waveOutGetDevCaps 函式 (mmeapi.h)

  • 發行項

waveOutGetDevCaps 函式會擷取指定電壓音訊輸出裝置的功能。

語法

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS pwoc,
  UINT          cbwoc
);

參數

uDeviceID

電壓/音訊輸出裝置的標識碼。 它可以是裝置標識碼或開啟的電壓輸出裝置的句柄。

pwoc

要填入裝置功能相關信息的 WAVEOUTCAPS 結構的指標。

cbwoc

WAVEOUTCAPS 結構的大小，以位元組為單位。

傳回值

如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。

傳回碼 Description
MMSYSERR_BADDEVICEID
 指定的裝置識別碼超出範圍。
MMSYSERR_NODRIVER
 沒有設備驅動器。
MMSYSERR_NOMEM
 無法配置或鎖定記憶體。

備註

使用 waveOutGetNumDevs 函式來判斷系統中存在的電壓音訊輸出裝置數目。 如果 uDeviceID 參數所指定的值是裝置識別碼，它可能會從零到一個小於存在的裝置數目。 WAVE_MAPPER常數也可以當做裝置標識碼使用。 只有 cbwoc 位元組 (或更少的資訊) 會複製到 pwoc 所指向的位置。 如果 cbwoc 為零，則不會複製任何專案，且函式會傳回零。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mmeapi.h (包含 Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll

另請參閱

電壓音訊

電壓函數