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