waveOutGetDevCapsA 函式會擷取指定波形音訊輸出裝置的功能。 這是函數的 ANSI 版本。
語法
MMRESULT waveOutGetDevCapsA(
UINT_PTR uDeviceID,
LPWAVEOUTCAPSA pwoc,
UINT cbwoc
);
參數
uDeviceID
波形音訊輸出裝置的識別碼。 它可以是裝置識別碼，也可以是開放波形音訊輸出裝置的句柄。
pwoc
指向 WAVEOUTCAPSA 結構的指標，以填入裝置功能的相關資訊。
cbwoc
WAVEOUTCAPSA 結構的大小 （以位元組為單位）。
返回值
如果成功，則傳回MMSYSERR_NOERROR，否則傳回錯誤。 可能的錯誤值包括下列項目。
| 回傳碼 | Description |
|---|---|
| MMSYSERR_BADDEVICEID | 指定的裝置識別碼超出範圍。 |
| MMSYSERR_NODRIVER | 沒有裝置驅動程式。 |
| MMSYSERR_NOMEM | 無法配置或鎖定記憶體。 |
備註
使用 waveOutGetNumDevs 函式來判斷系統中存在的波形音訊輸出裝置數目。 如果 uDeviceID 參數指定的值是裝置 ID，則它可能會比存在的裝置數目少 0 到 1。 WAVE_MAPPER常數也可以用作設備標識符。 只有 cbwoc 位元組（或更少）的資訊被複製到 pwoc指向的位置。 如果 cbwoc 為零，則不會複製任何內容，且函式會傳回零。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 |
| 支援的最低伺服器 | Windows 2000 伺服器 |
| Header | mmeapi.h |
| Library | Winmm.lib 網站 |
| DLL | Winmm.dll |