共用方式為


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 介面