Share via

waveOutGetDevCaps 関数 (mmeapi.h)

  • [アーティクル]

waveOutGetDevCaps 関数は、特定の波形オーディオ出力デバイスの機能を取得します。

構文

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

パラメーター

uDeviceID

波形オーディオ出力デバイスの識別子。 これは、デバイス識別子またはオープン波形オーディオ出力デバイスのハンドルのいずれかです。

pwoc

デバイスの機能に関する情報が入力される WAVEOUTCAPS 構造体へのポインター。

cbwoc

WAVEOUTCAPS 構造体のサイズ (バイト単位)。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
MMSYSERR_BADDEVICEID
 指定されたデバイス識別子が範囲外です。
MMSYSERR_NODRIVER
 デバイス ドライバーが存在しません。
MMSYSERR_NOMEM
 メモリを割り当てまたはロックできません。

注釈

waveOutGetNumDevs 関数を使用して、システムに存在する波形オーディオ出力デバイスの数を決定します。 uDeviceID パラメーターで指定された値がデバイス識別子の場合、0 から 1 つ小さいデバイスの数まで変化する可能性があります。 WAVE_MAPPER定数は、デバイス識別子としても使用できます。 情報の cbwoc バイト (以下) のみが 、pwoc が指す場所にコピーされます。 cbwoc が 0 の場合、何もコピーされません。関数は 0 を返します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

こちらもご覧ください

波形オーディオ

波形関数