IDmaChannelSlave::WaitForTC 方法 (portcls.h)

WaitForTC 方法等待 DMA 传输终端计数完成,或者如果指定的超时间隔首先过期,则超时。

语法

NTSTATUS WaitForTC(
  ULONG Timeout
);

参数

Timeout

以微秒为单位指定超时间隔。 此间隔是方法等待传输在超时之前完成的时间长度。指定的超时间隔向下舍入为最接近的十微秒增量。

返回值

WaitForTC 方法返回 NTSTATUS。 如果调用成功,它将返回STATUS_SUCCESS。 否则,该方法将返回适当的错误代码。

言论

注意

Microsoft支持多样化的包容性环境。 本文包含有关无偏见通信 Microsoft风格指南 识别为排除项的术语的参考。 本文中的单词或短语用于一致性,因为它当前显示在软件中。 当软件更新为删除语言时,本文将更新为对齐方式。

仅应在两种情况下调用此方法:

  1. 向硬件发送请求以停止后,微型端口驱动程序会调用 WaitForTC,以便等待 DMA 完成,然后再继续执行。

  2. 对于未自动初始化的 DMA 硬件,微型端口驱动程序可以随时调用 WaitForTC,等待 DMA 传输完成。

由于此方法只需等待 DMA 传输完成或超时,WaitForTC 的调用方必须在 IRQL PASSIVE_LEVEL运行。

要求

要求 价值
标头 portcls.h
IRQL PASSIVE_LEVEL(请参阅“备注”部分)。

另请参阅

IDmaChannelSlave 接口