报告 Miracast 对 Windows 8.1 上的区块和统计信息进行编码

在 Windows 8.1 上，显示硬件可以通过将帧拆分为多个部分或 对区块进行编码来处理通过 Miracast 无线显示链接发送的每个视频帧。 每个区块都有一个唯一的区块 ID，该 ID 是从帧号和帧部件（或切片）编号生成的。 必须为与同一桌面帧更新相关的每个区块分配相同的帧编号。

报告区块处理

驱动程序可以在多个处理步骤（例如将颜色转换与编码分离）或单个步骤中，对通过 Miracast 无线链接发送的帧进行编码。 每个处理步骤都应在帧内分配一个唯一的帧部件号。

Miracast 用户模式驱动程序或显示微型端口驱动程序每次必须通知操作系统：

• 硬件已完成帧的处理步骤。
• 紧接在帧的每个部分发送到网络之前。

假定特定报告处理步骤的时间是向操作系统报告事件的时间，因此必须尽快报告阶段。

除了使用 Windows 事件跟踪（ETW）内核级跟踪设施记录这些事件之外，操作系统不采取任何操作。 然而，此信息对于衡量和调查性能问题非常重要。

驱动程序可以使用以下可能的方法之一提供通知：

• Miracast 用户模式驱动程序调用 ReportStatistic 回调函数来报告具有 MIRACAST_STATISTIC_TYPE_CHUNK_PROCESSING_COMPLETE 类型的详细信息，或者通过 MIRACAST_STATISTIC_TYPE_CHUNK_SENT 指示区块即将发送到网络堆栈进行传输。
• 显示微型端口驱动程序使用DXGK_INTERRUPT_MICACAST_CHUNK_PROCESSING_COMPLETE中断类型报告区块处理的详细信息，尽管此报告只能在中断时进行。 除了记录区块信息之外，还创建并排队了区块数据包，以便 Miracast 用户模式驱动程序可以通过调用 GetNextChunkData 回调函数来检索它。
• 显示微型端口驱动程序在任何 IRQL 级别调用 DxgkCbReportChunkInfo 回调函数。 此函数仅记录区块信息，并且不会对任何区块数据包进行排队。

如果未更新桌面映像，但驱动程序需要再次对桌面图像进行编码以提高质量，则应使用相同的帧号和部件号。 性能工具触发同一帧和部件号的第二个编码完整事件，指示执行同一帧的第二次编码。

每个帧的最后一个切片必须有一个帧部件号为零，这表示帧的最后一个切片到性能工具。

若要确保主图面的正确同步，如果像素管道执行编码，则不应在编码完成访问主图面之前报告任何请求的翻转操作。 此行为可防止演示者在从主图面进行读取时呈现到主图面。

Miracast 用户模式驱动程序应在处理帧的每个阶段通知操作系统：

• 开始帧、区块类型 MIRACAST_CHUNK_TYPE_FRAME_START

  表示操作系统要求驱动程序显示新桌面帧的点。 尽管从技术上说，Miracast 用户模式驱动程序可以报告此阶段，但处理新帧的开始始终涉及显示微型端口驱动程序，因此应由该驱动程序报告。

• 颜色转换完成，区块类型 MIRACAST_CHUNK_TYPE_COLOR_CONVERT_COMPLETE

  某些解决方案具有单独的颜色转换和编码阶段。 在此类解决方案中，应尽快报告颜色转换完成处理事件，驱动程序应使用 DXGK_MIRACAST_CHUNK_INFO。ProcessingTime 成员报告硬件执行操作所需的时间。 如果整个帧一次性全部转换，而不是在切片中转换，则部件号应为零。

• 编码完整区块类型 MIRACAST_CHUNK_TYPE_ENCODE_COMPLETE

  指示 H.264 编码已完成。 应完成DXGK_MIRACAST_CHUNK_INFO结构的 ProcessingTime 和 EncodeRate 成员。

• 帧发送，使用 MIRACAST_STATISTIC_TYPE_CHUNK_SENT 调用 ReportStatistic

  指示 Miracast 用户模式驱动程序即将将此帧/部件号的数据包发送到网络 API 进行传输。 如果此帧/部件的数据是使用对网络 API 的多个调用发送的，则只应在发送第一个数据包之前记录它。 应在调用网络 API 之前进行调用。 此计时很重要，因为如果网络 API 阻止调用，我们不希望阻止的时间计入图形堆栈中帧的处理。

• 删除的帧、区块类型 MIRACAST_CHUNK_TYPE_FRAME_DROPPED

  如果驱动程序随时决定它不会完成帧/部件的处理，并将其发送到接收器，则应报告丢弃的帧。 在此上下文中，仅当驱动程序通过记录 MIRACAST_CHUNK_TYPE_FRAME_START开始处理帧时，才会考虑删除帧。 如果驱动程序计算它将跳过此帧而不进行任何处理，则它可以记录 MIRACAST_CHUNK_TYPE_FRAME_DROPPED 而不记录 MIRACAST_CHUNK_TYPE_FRAME_START。

• 驱动程序定义的区块类型 MIRACAST_CHUNK_TYPE_ENCODE_DRIVER_DEFINED_1 或 _2

  这些区块类型可用于帮助你了解方案的性能。 示例包括：

  • 驱动程序使用这些类型来指示为此帧创建了 I-Frame。
  • 驱动程序在帧的最后一个切片发送到包含编码帧总大小的网络 API 后记录另一个数据包。

帧颜色转换示例

以下示例演示如何转换帧颜色，以及显示微型端口驱动程序如何报告颜色转换的完成情况。

对MIRACAST_CHUNK_INFO结构成员的表引用包括：

• ChunkType 是 MIRACAST_CHUNK_TYPE_XXX 值。

• FrameNumber 和 PartNumber 是 ChunkId 联合的成员。

• ProcessingTime 是以微秒为单位的时间。

• EncodeRate 每秒以千比特为单位。

MIRACAST_STATISTIC_TYPE_CHUNK_SENT用于涉及对 ReportStatistic 调用的处理阶段。

在不使用切片的情况下报告单个帧

报告单个帧，使用切片进行处理

报告原始帧，处理后重新编码，而不使用切片

报告协议事件

当 Miracast 用户模式驱动程序使用 MIRACAST_STATISTIC_DATA 调用 ReportStatistic 函数来报告协议事件时。StatisticType 设置为MIRACAST_STATISTIC_TYPE_EVENT，操作系统会记录事件，但不采取其他操作。 然而，这些事件对于诊断和性能调查非常有用。

MIRACAST_PROTOCOL_EVENT枚举包括可以报告的可能协议事件类型。

报告协议错误

当 Miracast 连接的会话正在进行时，如果 Miracast 用户模式驱动程序发现错误，则应在 MiracastStatus 参数中使用适当的MIRACAST_STATUS错误状态信息调用 ReportSessionStatus 回调函数。 报告错误时，操作会话始终会销毁会话。

尽管操作系统只是记录 ReportSessionStatus Status 参数进行诊断，并且不根据其值执行任何操作，但驱动程序应使用此参数来区分错误的不同原因。