realize 命令

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

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

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

參數

lpszDeviceID

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

lpszPalette

下列其中一個旗標。

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

lpszFlags

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

傳回值

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

備註

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

範例

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

realize myvideo normal

規格需求

另請參閱

Mci

MCI 命令字串