共用方式為


(portcls.h) IDmaChannelSysteme::WaitForTC 方法

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 (请参阅一节。)

另請參閱

IDmaChannel在介面上