IDmaChannelSlave::WaitForTC 方法 (portcls.h)
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 (請參閱一節。 |