window 命令

窗口命令控制显示窗口。 可以使用此命令更改窗口的显示特征,或提供目标窗口供驱动程序使用,以取代默认显示窗口。 数字视频和视频覆盖设备可识别此命令。

若要发送此命令,请使用 lpszCommand 参数集调用 mciSendString 函数,如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("window %s %s %s"), 
  lpszDeviceID, 
  lpszWindowFlags, 
  lpszFlags
); 

参数

lpszDeviceID

MCI 设备的标识符。 打开设备时会分配此标识符或别名。

lpszWindowFlags

用于控制显示窗口的标志。 下表列出了可识别窗口命令的设备类型以及每种类型使用的标志。

含义 含义
digitalvideo handle hwnd state hidestate minimizestate restorestate showshow maximized show minimizedshow min noactiveshow nashow noactivateshow normaltext 描述文字
overlay fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizestate minimizedstate no actionstate noactivatestate normal state restorestate showshow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext 描述文字

下表列出了可在 lpszWindowFlags 参数中指定的标志及其含义。

含义
fixed 禁用图像的拉伸。
handle default 指定设备应将显示窗口设置回 打开 操作期间创建的默认窗口。 对于视频覆盖设备,指定设备应创建和管理其自己的目标窗口。
handle hwnd 指定要使用的目标窗口而不是默认窗口的句柄。 hwnd 参数包含与 CreateWindow 函数返回的窗口句柄等效的 ASCII 数字。 两个设备实例可以使用同一窗口句柄,前提是每个实例更新窗口中的视频和图像像素,就好像另一个实例不存在一样。 当禁用 了设置视频 “关闭”的视频输出时, 更新 命令将使目标矩形成为纯色。
显示最大化 最大化目标窗口。
show min noactive 将目标窗口显示为图标。
显示最小化 最小化目标窗口。
show na 显示当前状态的目标窗口;当前处于活动状态的窗口保持活动状态。
show noactivate 以最新大小和位置显示目标窗口;当前处于活动状态的窗口保持活动状态。
显示正常 激活并显示目标窗口的原始大小和位置。 (这与“状态还原”标志相同。)
状态隐藏 隐藏目标窗口。
状态图标 将目标窗口显示为图标。
状态最大化 最大化目标窗口。
状态最小化 最小化目标窗口并激活窗口管理器列表中的顶级窗口。
状态最小化 最小化目标窗口。
状态无操作 显示当前状态的目标窗口。 当前处于活动状态的窗口仍保持活动状态。
state noactivate 以最新大小和状态显示目标窗口。 当前活动的窗口仍保持活动状态。
state normal 激活并显示目标窗口的原始大小和位置。
状态还原 激活并显示目标窗口的原始大小和位置。
状态显示 显示目标窗口。
Stretch — 拉伸 启用图像拉伸。
文本描述文字 指定目标窗口的描述文字。 如果此文本包含嵌入的空白,则整个描述文字必须用引号引起来。 默认窗口的默认描述文字为空。

lpszFlags

可以是“等待”、“通知”或两者。 对于数字视频设备,还可以指定“测试”。 有关这些标志的详细信息,请参阅 等待、通知和测试标志

返回值

如果成功,则返回零,否则返回错误。

备注

视频覆盖设备通常在打开时创建并显示一个窗口。 如果应用程序为驱动程序提供了一个窗口,则应用程序负责管理发送到该窗口的消息。

由于可以使用 status 命令检索驱动程序显示窗口的句柄,因此还可以使用标准窗口管理器函数(如 ShowWindow) ) (来操作窗口。

示例

以下命令显示并设置“电影”播放窗口的描述文字。

window movie text "Welcome to the Movies" state show

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]

另请参阅

Mci

MCI 命令字符串

open

玩游戏

setvideo

update