IDmaChannelSlave::WaitForTC メソッド (portcls.h)
WaitForTC メソッドは、DMA 転送ターミナル数が完了するまで待機するか、指定されたタイムアウト間隔が最初に期限切れになるとタイムアウトします。
構文
NTSTATUS WaitForTC(
ULONG Timeout
);
パラメーター
Timeout
タイムアウト間隔をマイクロ秒単位で指定します。 この間隔は、メソッドが転送の完了を待機してからタイムアウトするまでの時間の長さです。指定されたタイムアウト間隔は、最も近い 10 マイクロ秒の増分に切り捨てられます。
戻り値
WaitForTC メソッドは NTSTATUS を返します。 呼び出しが成功した場合は、STATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。
注釈
注意
Microsoft は、多様で包括的な環境をサポートしています。 この記事には、 バイアスフリー通信の Microsoft スタイル ガイド で除外として認識される用語への参照が含まれています。 この記事では、ソフトウェアに現在表示されているため、一貫性を保つ目的で単語または語句を使用します。 言語を削除するようにソフトウェアが更新されると、この記事は一致するように更新されます。
このメソッドは、次の 2 つの状況でのみ呼び出す必要があります。
停止するハードウェアに要求を送信した後、ミニポート ドライバーは、DMA が完了するまで待機するために WaitForTC を呼び出してから実行を続行します。
自動初期化されていない DMA ハードウェアの場合、ミニポート ドライバーは、DMA 転送が完了するまで待機する WaitForTC をいつでも呼び出すことができます。
このメソッドは単に DMA 転送が完了するかタイムアウトするまで待機するため、WaitForTC の呼び出し元は IRQL PASSIVE_LEVELで実行されている必要があります。
要件
| 要件 | 値 |
|---|---|
| Header | portcls.h |
| IRQL | PASSIVE_LEVEL (「解説」セクションを参照)。 |