mixerGetDevCapsA 函式 (mmeapi.h)

混音器GetDevCaps函式會查詢指定的混音器裝置來判斷其功能。

語法

MMRESULT mixerGetDevCapsA(
  UINT_PTR     uMxId,
  LPMIXERCAPSA pmxcaps,
  UINT         cbmxcaps
);

uMxId

開啟混合器裝置的識別碼或控制碼。

pmxcaps

可接收裝置功能相關資訊的 MIXERCAPS 結構的指標。

cbmxcaps

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

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

使用混合器GetNumDevs 函式來判斷系統中存在的混合器裝置數目。 uMxId指定的裝置識別碼會從零到一個小於混合器裝置數目。

只有 cbmxcaps 中指定的資訊 (或更少) 位元組數目會複製到 pmxcaps所指向的位置。如果 cbmxcaps 為零，則不會複製任何專案，而且函式會成功傳回。

此函式也會接受混合器裝置控制碼，而混合器Open 函式傳回做為 uMxId 參數。應用程式應該將 HMIXER 控制碼轉換成 UINT。

注意

mmeapi.h 標頭會將 mixerGetDevCaps 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。