setaudio 命令

  • 發行項

setaudio 命令會設定與音訊播放和擷取相關聯的值。 數位視訊和 VCR 裝置可辨識此命令。

若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("setaudio %s %s %s"), 
  lpszDeviceID, 
  lpszAudio, 
  lpszFlags
);

參數

lpszDeviceID

MCI 裝置的識別碼。 當裝置開啟時，會指派此識別碼或別名。

lpszAudio

音訊播放和擷取的旗標。 下表列出可辨識 setaudio 命令的裝置類型，以及每個類型所使用的旗標。

值 意義 意義
digitalvideo 演算法 演算法對齊 整數基底以 因數bitspersample， 以將 位元組秒bit_count到左邊磁片區左左的 整數時鐘時間輸入 ，以在輸出上降低 持續時間品質描述元在右側磁片區右邊的右下記錄記錄，以將整數來源加到sourcename資料流程的整數來源，以將分量分解為因素
錄影機 off on monitor to typenumber numberrecord off record off track_number off 記錄追蹤上的記錄track_number，以輸入數位追蹤track_number關閉追蹤track_number

下表列出可以在 lpszAudio 參數及其意義中指定的旗標。

值 意義
演算法 演算法 選取特定的音訊壓縮演算法，以供後續 保留 或 錄製 命令使用。 支援的演算法是裝置特定的。 MCI 會定義 演算法的值 「g711」、「g721」、「g722」、「g728」、「pcm」、「cdxa」、「adpcm」和 「adpcm4e」。 如果裝置支援演算法名稱 「pcm」、「cdxa」 和 「adpcm4e」，它們會遵守標準定義。 「cdxa」 演算法已由 Corporation 定義。 Intel Corporation 已定義 「adpcm4e」 演算法。 「g711」、「g721」、「g722」 和 「g728」 值代表國際電報和電話諮詢委員會建議的音訊演算法， (CCITT) 。
如果指定的演算法與目前的檔案格式衝突，則檔案格式會變更為演算法的預設格式。
對齊為 整數 設定相對於輸入波音訊資料開始的資料區塊對齊方式。
bass to factor 設定音訊低頻率層級。
bitspersample 至 bit_count 設定每個記錄樣本的位數。 檔案會以這個格式儲存。 此旗標僅適用于支援 「pcm」 演算法的裝置。
bytespersec 到 integer 設定在 「pcm」 和 「adpcm」 演算法中記錄的平均每秒位元組數。 檔案會以這個格式儲存。
clocktime 指出 「over」 旗標中指定的時間以毫秒為單位。 這次是絕對的，而不是逐步播放工作區。
input 修改 「bass」、「treble」 或 「volume」 旗標，使其會影響輸入訊號，並修改所錄製的內容。 可能的話，這是監視輸入時的預設值。
左下左 啟用或停用左側通道上的音訊輸出。 音訊簡報來源可以是外部輸入或工作區。 預設值為 「left on」。 如果只有一個通道，該通道就會開啟或關閉。
左磁片區到 因素 設定左側音訊通道的音訊音量。 如果只有一個通道，則會設定其磁片區。
監視以輸入數位 控制哪些來源輸入會傳遞至 VCR 輸出，而不需變更錄製來源輸入選取範圍。 類型 可以是「輸出」或其中一個有效的輸入來源。 如果未指定 number ，則會選擇該類型的第一個輸入。
關閉 啟用或停用音訊。 音訊簡報來源可以是外部輸入或工作區。 此命令會同時影響左右音訊通道。 預設值為 setaudio 「on」。
output 修改 「bass」、「treble」 或 「volume」 旗標，使其只修改播放的訊號，而不是錄製的內容。 可能的話，這是監視檔案時的預設值。
持續期間 指定使用 因數 變數進行變更所需的時間。 持續時間的單位是目前的時間格式。 變更會隨著工作區的播放而逐步發生。 當播放暫停時，變更也會暫停，直到播放繼續為止。 如果未指定或不支援「超過」，就會立即進行變更。
品質 描述項 指定將音訊錄製到檔案時所執行的音訊壓縮特性。 所有裝置都支援三個描述項「低」、「中」和「高」。 預設值為裝置特定。如果未指定「演算法」旗標，「品質」調整會套用至目前的演算法。
品質命令可用來定義其他描述元名稱。
記錄關閉 清除音訊來源選取範圍，讓下一 個錄製 命令不會錄製任何音訊。
記錄開啟 啟用音訊資料的錄製。 預設值是錄製音訊資料。
記錄追蹤 track_number 關閉 清除音訊來源選取範圍，讓下一 個錄製 命令不會錄製任何音訊。 「追蹤」允許獨立追蹤選取。 追蹤 2 對應至 Hi8 中的 PCM 追蹤。 如果未指定 「track」 ，則會假設預設值為 1。
記錄追蹤track_number 選取要以下一 個記錄 命令錄製的音訊來源。 「追蹤」允許獨立追蹤選取。 追蹤 2 對應至 Hi8 中的 PCM 追蹤。 如果未指定 「track」 ，則會假設預設值為 1。
右下右方 啟用或停用右側通道上的音訊輸出。 音訊簡報來源可以是外部輸入或工作區。 預設值為 「right on」。 如果只有一個通道，這個旗標就不會有任何作用。
要考慮的右磁片 區 將音訊音量設定為正確的音訊通道。 如果只有一個通道，則沒有任何作用。
samplespersec 至 integer 使用 「pcm」 和 「adpcm」 演算法設定錄製的取樣率。 檔案會以此格式儲存。
source to sourcename 指定音訊輸入數位板的來源。 針對 sourcename定義的常數包括：「left」、「right」、「average」 和 「stereo」。 前三個只使用左輸入指定單音錄製、僅右輸入，以及兩個輸入的平均值。
source to type number number 選取要錄製于磁帶上的音訊來源。 類型 必須是 「tuner」、「line」、「svideo」、「aux」、「generic」 或 「mute」。
資料流程到 數位 指定從工作區播放的音訊資料流程。 如果未指定資料流程，而且檔案格式未定義預設值，則會先播放實際交錯的音訊資料流程。
追蹤 track_number 關閉 停用個別追蹤。
追蹤 track_number 開啟 啟用個別追蹤。
三元到 因素 設定音訊高頻率層級。
要考慮的磁片區 設定這兩個音訊通道的平均音訊音量。 如果左右磁片區已設定為不同的值，則左至右磁片區的比率大約不會變更。

lpszFlags

可以是 「等候」、「通知」、「測試」或這些組合。 如需這些旗標的詳細資訊，請參閱 等候、通知和測試旗標。

傳回值

如果成功或發生錯誤，則傳回零。

備註

針對 VCR 裝置，使用 setaudio 搭配旗標來關閉個別追蹤 (「追蹤 track_number 關閉」) 可能會導致您的應用程式收到狀態訊息，指出無法執行命令。某些VCR 只能關閉曲目的組合，而不是個別的曲目;例如，第一個音訊播放軌和視訊播放軌的視訊播放軌。 在此情況下，只要使用 setaudio 和 setvideo 繼續關閉構成組合的其他曲目。 驅動程式會在收到 命令時關閉曲目，以關閉組合中的最後一個曲目。

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]

另請參閱

Mci

MCI 命令字串

record

儲備

setvideo