update コマンド

update コマンドは、現在のフレームを指定されたデバイスコンテキスト (DC) に再描画します。デジタルビデオデバイスはこのコマンドを認識します。

このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。

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

パラメーター

lpszDeviceID

MCI デバイスの識別子。この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszHDC

DC のハンドル。次の表に、 update コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値	説明	説明
digitalvideo	hdc hdc hdc hdc at rect	ペイント hdc hdc

次の表に、 lpszHDC パラメーターで指定できるフラグとその意味を示します。

値	説明
hdc hdc	ペイントする DC のハンドルを指定します。
hdc hdc at rect	クライアントの四角形に対する相対的なクリッピング四角形を指定します。
ペイント hdc hdc	アプリケーションが DC 用の WM_PAINT メッセージを受信したときに DC を描画します。

DC のハンドルを指定するには、文字列 "hdc" の後にハンドルの ASCII 表現を使用します。四角形はX1 Y1 X2 Y2 として指定されます。座標X1 Y1は四角形の左上隅を指定し、座標X2 Y2は幅と高さを指定します。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。デジタルビデオデバイスの場合は、"テスト" を指定することもできます。これらのフラグの詳細については、「待機、通知、テストフラグ」を参照してください。

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

次のコマンドは、"movie" デバイスで使用される表示ウィンドウ全体を更新します。数値 203 は、 BeginPaint 関数から取得した DC へのハンドルです。

update movie hdc 203

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]