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 參數指定的值是裝置 ID，則它可能會比存在的裝置數目少 0 到 1。 WAVE_MAPPER常數也可以用作設備標識符。 只有 cbwoc 位元組（或更少）的資訊被複製到 pwoc指向的位置。 如果 cbwoc 為零，則不會複製任何內容，且函式會傳回零。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | mmeapi.h （包括 Windows.h） |
| Library | Winmm.lib 網站 |
| DLL | Winmm.dll |