signal 命令

訊號命令會傳送應用程式 MM_MCISIGNAL 訊息，以識別工作區中的指定位置。數位視訊裝置可辨識此命令。 MCIAVI 一次只支援一個作用中的訊號。

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

_stprintf_s(
  lpszCommand, 
  TEXT("signal %s %s %s"), 
  lpszDeviceID, 
  lpszSignalFlags, 
  lpszFlags
);

參數

lpszDeviceID

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

lpszSignalFlags

下列其中一個旗標。

值	意義
位置	指定要叫用訊號的框架。
cancel	從工作區移除訊號。使用「uservalue」旗標來指定個別訊號。如果未使用「cancel」指定「uservalue」旗標，則裝置會取消所有訊號。「cancel」旗標與「at」、「every」和「return position」旗標不相容。
每個間隔	指定訊號的期間。間隔值是以目前的時間格式指定。如果搭配「at」位置使用，則訊號會放在工作區中，並放置一個訊號標記。若沒有「at」旗標，訊號會放在工作區中，並具有目前位置的一個訊號。如果省略此旗標，則只會標示「at」旗標所指示的位置。如果間隔值小於裝置所支援的最低頻率，則會使用其最小值。
傳回位置	表示裝置應該傳送位置值，而不是訊號訊息中的「uservalue」識別碼。「uservalue」識別碼仍可用來取消或重新定義訊號標記。
uservalue id	指定以訊號訊息回報的識別碼。此識別碼可作為可與其他訊號命令搭配使用的識別碼，以參考此訊號設定。如果省略，預設值為零。

lpszFlags

可以是「wait」、「notify」、「test」或這些組合。如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。

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

用於命令完成訊息通知的視窗控制碼也用於發出訊號。

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