setvideo 命令
setvideo 命令设置与视频播放和捕获关联的值。 数字视频和 VCR 设备可识别此命令。
若要发送此命令，请使用 lpszCommand 参数集调用 mciSendString 函数，如下所示。
_stprintf_s(
lpszCommand,
TEXT("setvideo %s %s %s"),
lpszDeviceID,
lpszVideo,
lpszFlags
);
parameters
-
lpszDeviceID
-
MCI 设备的标识符。 打开设备时会分配此标识符或别名。
-
lpszVideo
-
视频播放和捕获的标志。 下表列出了可识别 setvideo 命令的设备类型以及每种类型使用的标志。
值 含义 含义 digitalvideo algorithm algorithmbitsperpel to countbrightness to factorclocktimecolor to factorcontrast to factorgamma to valuehalftoneinputkey color to r：g：bkey index to indexoffonoutput 持续时间的调色板颜色超过索引到 newrgb 调色板句柄，以处理质量描述符记录帧速率到速率记录上记录从因素源到源数字值的脱色度，仍然算法仍在质量描述符流到数字色调到因子 录像机 offonmonitor 用于键入数字记录offrecord 跟踪track_number off record onrecord track track_number onsource 中键入编号跟踪track_number offtrack track_number 下表列出了可在 lpszVideo 参数中指定的标志及其含义。
值 含义 算法 指定供后续 保留 或 录制 命令使用的视频压缩算法。 设备支持的算法特定于设备。 MCI 定义 算法的常量“mpeg”和“h261”。如果指定的算法与当前文件格式冲突，则文件格式将更改为算法的默认格式。 bitsperpel to count 使用 捕获 或 记录 命令设置每像素保存数据的位数。 要因数的亮度 设置视频亮度级别。 clocktime 指示在“over”标志中指定的时间以毫秒为单位。 时间是绝对的，与工作区的播放不同步。 要 因数而来的颜色 设置颜色饱和度级别。 与因子的对比 设置视频对比度级别。 gamma 到 值 指定伽玛校正指数乘以 1000。 例如，若要指定指数 2.2，请使用 2200 作为 值。 伽玛值 1.0 (1000) 表示未应用伽玛校正。 伽玛校正调整表示源中编码的强度与显示的亮度之间的映射。 半 色调 导致使用半色调调色板而不是默认调色板。 此标志仅由 MCIAVI 数字视频驱动程序识别。 input 修改“亮度”、“颜色”、“对比度”、“伽玛”、“锐度”或“淡色”标志，以便影响输入信号并修改所记录的内容。 如果可能，这是监视输入时的默认值。 将键颜色设置为 r：g：b 设置键颜色。 r：g：b 变量为 RGB 值。 冒号 (：) 分隔单独的红色、绿色和蓝色值。 键索引到 索引 设置键索引。 索引变量是物理调色板索引。 监视器以 键入 number number 控制将传递到 VCR 输出的源输入，而无需更改录制源输入选择。 类型可以是“输出”，也可以是有效的输入源之一。 如果未指定“number”，则选择该类型的第一个输入。 offon 启用或禁用视频显示。 禁用视频会将 放置 “目标”矩形中的像素设置为 (或其默认值，当前窗口的客户端区域) 纯色。 它对帧缓冲区没有影响。视频源（无论是工作区还是外部输入）可能会继续将新图像存储在帧缓冲区中。 在启用视频之前，它们不会显示。 可以使用 窗口 “state”命令隐藏窗口。 默认值为 setvideo “on”。 output 修改“亮度”、“颜色”、“对比度”、“伽玛”、“锐度”或“淡色”标志，以便它仅修改显示的信号，而不修改记录的内容。 如果可能，这是监视文件时的默认值。 持续时间 指定使用 因子 变量进行更改所需的时间。 持续时间的单位采用当前时间格式。 更改会随着工作区的播放而发生。 暂停播放时，更改也会暂停，直到播放继续。 如果未使用或不支持“over”，则更改会立即发生。 调色板 颜色 超过 索引 到 newrgb 设置新的调色板颜色。 要更改的颜色和调色板索引由 颜色 和 索引 参数指定;新颜色由 newrgb 指定。 此标志仅由 MCIAVI 数字视频驱动程序识别。 要处理的调色板句柄 指定设备必须用于呈现的调色板的句柄。 只有使用调色板的设备才支持此项。 如果 句柄 为零，则使用默认调色板。数字视频设备不应释放使用此命令传递的调色板。 应用程序应在关闭设备后释放它。 质量 描述符 指定将视频录制到文件时执行的视频压缩的特征。 所有设备都支持三个描述符：“low”、“medium”和“high”。 默认值特定于设备。 这些名称的重要性取决于算法和设备。 设备可以定义其他描述符名称。 quality 命令可用于定义其他描述符名称。如果未使用“algorithm”标志，则描述符将应用于当前算法。 记录帧速率到 速率 设置动作视频的录制。 录制 速率 以帧/秒单位乘以 1000 指定。 例如，29.97 帧/秒的 NTSC 帧速率表示为 29970。 record onrecord off 启用或禁用视频数据的录制。 录制视频数据是默认设置。 记录 跟踪track_number 关闭 清除视频源选择，以便下一个录制命令不会录制任何 视频 。 “跟踪”允许独立选择曲目。 如果未指定“track”，则假定默认值为 1。 可能需要先发出 一组 “汇编录制关闭”命令，然后才能关闭视频录制。 记录跟踪track_number 选择要使用下一个录制命令 录制 的视频源。 “跟踪”允许独立选择曲目。 轨道 2 对应于 Hi8 中的 PCM 轨道。 如果未指定“track”，则假定默认值为 1。 锐度到 因素 设置视频清晰度级别。 源到 源 编号 值 设置视频输入的源。 这通常对应于外部连接器。 为 源 定义的常量包括“rgb”、“pal”、“ntsc”、“svideo”和“secam”。 如果存在指定类型的多个输入，则可选的“number” 值 指示所需的输入。 例如， setvideo “source to ntsc number 2”指定第二个 NTSC 输入。如果省略“to” 源 ，则绝对源按 列表 “视频源”命令的定义使用。 源以 键入 数字 编号 选择要在磁带上录制的视频源。 类型 必须为“tuner”、“line”、“svideo”、“aux”、“generic”、“mute”或“rgb”。 静态 算法 指定 捕获 命令使用的静止图像压缩算法。 每个设备都必须支持“无” 算法 ，这意味着没有压缩。 这是默认设置。 在这种情况下，数字视频设备将静止图像保存为与 RGB 设备无关的位图。 设备可能还支持特定于设备的其他算法列表。 静止质量 描述符 指定捕获静止图像时执行的静止图像压缩的特征。 所有设备都支持描述符“low”、“medium”和“high”。 默认值特定于设备。如果未使用“algorithm”标志，则 描述符 将应用于当前算法。
quality 命令可用于定义其他描述符名称。流到 数字 指定从工作区播放的视频流。 如果未指定流，并且文件格式未定义默认流，则会播放物理上第一个交错的视频流。 色调到 因素 设置图像色调。 通常，这种调整是在许多彩色电视机的色调控制之后建模的，其中 250 表示绿色，750 表示红色，0 表示 (或 -
lpszFlags
-
可以是“等待”、“通知”、“测试”或这些组合。 有关这些标志的详细信息，请参阅 等待、通知和测试标志。
返回值
如果成功，则返回零，否则返回错误。
备注
对于 VCR 设备，将 setvideo 与关闭单个轨迹 (“跟踪 track_number 关闭”) 的标志结合使用可能会导致应用程序收到指示无法执行命令的状态消息。某些 VCR 只能关闭轨道的组合，而不能关闭单个轨道的组合;例如，第一个音频轨道和视频盒的视频轨。 在这种情况下，只需使用 setaudio 和 setvideo 继续关闭构成组合的其他曲目。 驱动程序在收到关闭组合中的最后一个音轨的命令时会关闭轨道。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |