acmDriverMessage 函式 (msacm.h)

  • 發行項

acmDriverMessage函式會將使用者定義的訊息傳送至指定的 ACM 驅動程式實例。

語法

LRESULT ACMAPI acmDriverMessage(
  HACMDRIVER had,
  UINT       uMsg,
  LPARAM     lParam1,
  LPARAM     lParam2
);

參數

had

將傳送訊息的 ACM 驅動程式實例控制碼。

uMsg

ACM 驅動程式必須處理的訊息。 此訊息必須位於高於或等於ACMDM_USER且小於ACMDM_RESERVED_LOW) (ACMDM_USER訊息範圍中。 這項限制的例外是ACMDM_DRIVER_ABOUT、 DRV_QUERYCONFIGURE和 DRV_CONFIGURE 訊息。

lParam1

訊息參數。

lParam2

訊息參數。

傳回值

傳回值專屬於 uMsg 參數所指定的使用者定義 ACM 驅動程式訊息。 不過，可能的錯誤值包括下列專案。

傳回碼 描述
MMSYSERR_INVALHANDLE
 指定的控制碼無效。
MMSYSERR_INVALPARAM
 uMsg參數不在ACMDM_USER範圍內。
MMSYSERR_NOTSUPPORTED
 ACM 驅動程式未處理訊息。

備註

若要從 ACM 驅動程式顯示自訂的 [關於] 對話方塊，應用程式必須將ACMDM_DRIVER_ABOUT訊息傳送至驅動程式。 lParam1參數應該是自訂 [關於] 對話方塊的擁有者視窗控制碼，且lParam2必須設定為零。 如果驅動程式不支援自訂的 [關於] 對話方塊，則會傳回MMSYSERR_NOTSUPPORTED，而且應用程式必須負責顯示自己的對話方塊。 例如，當 ACM 驅動程式傳回MMSYSERR_NOTSUPPORTED時，主控台音效對應程式選項會根據ACMDRIVERDETAILS結構顯示預設的 [關於] 對話方塊。 應用程式可以將 lParam1 設定為 –1L，以查詢驅動程式的自訂 About 對話方塊支援，而不會顯示對話方塊。 如果驅動程式支援自訂的 [關於] 對話方塊，則會傳回MMSYSERR_NOERROR。 否則，傳回值會MMSYSERR_NOTSUPPORTED。

使用者定義訊息只能傳送至特別支援訊息的 ACM 驅動程式。 呼叫端應該藉由擷取驅動程式詳細資料並檢查ACMDRIVERDETAILS結構的wMid、wPid和vdwDriver成員，確認 ACM 驅動程式是否為正確的驅動程式。

永遠不要將使用者定義的訊息傳送至未知的 ACM 驅動程式。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 msacm.h
程式庫 Msacm32.lib
Dll Msacm32.dll

另請參閱

音訊壓縮函式

音訊壓縮管理員