realize 命令

實現命令會指示裝置在顯示視窗的顯示內容中選取並實現其調色盤。 數位視訊裝置可辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("realize %s %s %s"), 
  lpszDeviceID, 
  lpszPalette, 
  lpszFlags
); 

參數

lpszDeviceID

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

lpszPalette

下列其中一個旗標。

意義
背景資訊 將調色盤視為背景調色盤。
正常 實現最上層視窗的調色盤。 這是預設值。

lpszFlags

可以是 「wait」、「notify」 或兩者。 對於數位視訊裝置,也可以指定「測試」。 如需這些旗標的詳細資訊,請參閱 等候、通知和測試旗標

傳回值

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

備註

只有在您的應用程式使用視窗控制碼並接收 WM_QUERYNEWPALLETTEWM_PALETTECHANGED 訊息時,才使用此命令。

範例

下列命令會指示 「myvideo」 裝置實現其調色盤。

realize myvideo normal

規格需求

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

另請參閱

Mci

MCI 命令字串