update 命令

更新命令會將目前的畫面重新繪製到指定的裝置內容 (DC) 。數位視訊裝置可辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("update %s %s %s"), 
  lpszDeviceID, 
  lpszHDC, 
  lpszFlags
);

參數

lpszDeviceID

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

lpszHDC

DC 的控制碼。下表列出可辨識更新命令的裝置類型，以及每種類型所使用的旗標。

值	意義	意義
digitalvideo	hdc hdc hdchdc at rect	繪製 hdc hdc

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

值	意義
hdc hdc	指定要繪製之 DC 的控制碼。
rect的hdc hdc	指定相對於用戶端矩形的裁剪矩形。
繪製 hdc hdc	當應用程式收到適用于 DC 的WM_PAINT 訊息時，繪製 DC。

若要指定 DC 的控制碼，請使用字串「hdc」，後面接著控制碼的 ASCII 標記法。矩形會指定為X1 Y1 X2 Y2。座標X1 Y1指定矩形的左上角，而座標 X2 Y2則指定寬度和高度。

lpszFlags

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

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

下列命令會更新「電影」裝置所使用的整個顯示視窗。數位 203 是從 BeginPaint 函式取得之 DC 的控制碼。

update movie hdc 203

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