restore 命令

還原命令會將仍然影像從檔案複製到框架緩衝區。這是擷取命令的反轉。數位視訊裝置可辨識此命令。

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

_stprintf_s(
  lpszCommand, 
  TEXT("restore %s %s %s"), 
  lpszDeviceID, 
  lpszRestore, 
  lpszFlags
);

參數

lpszDeviceID

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

lpszRestore

下列一或多個旗標。

值	意義
在矩形	指定相對於框架緩衝區原點的矩形。矩形會指定為X1 Y1 X2 Y2。座標 X1 Y1 會指定左上角，而座標 X2 Y2 指定寬度和高度。如果未使用此旗標，影像會複製到框架緩衝區的左上角。
從檔案名	指定要重新叫用的影像檔名。這個旗標是必要項目。

lpszFlags

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

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

裝置可以辨識各種影像格式;Windows 裝置獨立點陣圖一律可辨識。

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