(portcls.h) IDmaChannelSysteme::WaitForTC 方法
WaitForTC 方法會等候 DMA 傳輸終端機計數完成,或者如果指定的逾時間隔第一次到期,就會逾時。
語法
NTSTATUS WaitForTC(
ULONG Timeout
);
參數
Timeout
以毫秒為單位指定超時時間間隔。 這個間隔是方法等候傳送在逾時之前完成的時間長度。指定的超時時間間隔會無條件進位到最接近的十微秒遞增。
傳回值
WaitForTC 方法會傳回 NTSTATUS。 如果呼叫成功,它會傳回STATUS_SUCCESS。 否則,方法會傳回適當的錯誤碼。
備註
注意
Microsoft 支援多元且包容性的環境。 本文包含 無偏差通訊的 Microsoft 樣式指南 辨識為排除詞彙的參考。 本文中會使用單字或片語來保持一致性,因為它目前會出現在軟體中。 當軟體更新為移除語言時,本文將會更新為一致。
只有在兩種情況下,才應該呼叫這個方法:
將要求傳送至硬體以停止之後,迷你埠驅動程式會呼叫 WaitForTC,以等候 DMA 完成,再繼續執行。
在未自動初始化的 DMA 硬體案例中,迷你埠驅動程式可以隨時呼叫 WaitForTC 以等候 DMA 傳輸完成。
因為此方法只會等候 DMA 傳輸完成或逾時,所以 WaitForTC 的呼叫端必須在 IRQL PASSIVE_LEVEL執行。
規格需求
需求 | 值 |
---|---|
標頭 | portcls.h |
IRQL | PASSIVE_LEVEL (请参阅一节。) |