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 繼續關閉構成組合的其他曲目。 驅動程式會在收到 命令時關閉曲目，以關閉組合中的最後一個曲目。

規格需求

另請參閱

Mci

MCI 命令字串

record

儲備

setvideo