(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在介面上