CODECAPI_ALLSETTINGS
CODECAPI_ALLSETTINGS 属性用于来回传递微型驱动程序生成的数据块。
获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 | 是 | 筛选器 | KSPROPERTY | PVOID |
属性值 (操作数据) 的类型为 PVOID,它是指向微型驱动程序生成的数据块的用户模式缓冲区的指针。
注释
在属性上获取调用:
如果应用程序发出长度为零的缓冲区的属性 get 调用,微型驱动程序必须返回STATUS_BUFFER_OVERFLOW并在 Irp-IoStatus.Information> 字段中指定所需的缓冲区大小。 如果长度缓冲区不为零,则微型驱动程序必须返回STATUS_BUFFER_TOO_SMALL如果提供的缓冲区对于数据块来说太小,则微型驱动程序必须返回 ,否则微型驱动程序会将其设置打包到稍后可以还原的数据块中。
微型驱动程序负责向数据添加数据完整性检查,例如指示微型驱动程序生成数据的唯一 GUID、循环冗余检查 (CRC) 以及标头长度。
返回的数据应该是轻量级的,并且仅包含重新构造当前设置所需的信息。
应用程序将此属性用于多级撤消、与其项目一起存储等。
在属性集调用上:
微型驱动程序必须验证数据的完整性,检查数据块大小低于最大数据大小 (例如,拒绝超过特定大小的任何内容) 。 它还必须验证 CRC 和标头长度。 微型驱动程序还必须缓存要 传播CODECAPI_CURRENTCHANGELIST的任何更改。
要求
头: 在 ksmedia.h 中声明。 包括 ksmedia.h。