IDmaChannelSlave::Start メソッド (portcls.h)
Start メソッドは、下位 DMA オブジェクトを開始します。
構文
NTSTATUS Start(
ULONG MapSize,
BOOLEAN WriteToDevice
);
パラメーター
MapSize
マップする割り当て済みバッファーのバイト数を指定します。 マップ サイズは、IDmaChannel::AllocateBuffer の呼び出しで割り当てられたバッファーのサイズを超えることはできません。
WriteToDevice
データ移動の方向を指定します。 TRUE の場合、データはバッファーからデバイスに移動されます。 FALSE の場合、データはデバイスからバッファーに移動されます。
戻り値
このメソッドは NTSTATUS を返します。 呼び出しが成功した場合は、STATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。 呼び出し元が既に開始されているチャネルを開始しようとすると、メソッドはエラー コード STATUS_UNSUCCESSFULを使用して直ちにを返します。
注釈
注意
Microsoft は、多様で包括的な環境をサポートしています。 この記事には、 バイアスフリー通信の Microsoft スタイル ガイド が除外として認識する用語への参照が含まれています。 この単語または語句は、現在ソフトウェアに表示されているため、一貫性を保つ目的でこの記事で使用されています。 言語を削除するようにソフトウェアが更新されると、この記事は一致するように更新されます。
メソッドは、最初にマップ レジスタを設定して、アダプター オブジェクトに割り当てられたバッファーの最初の MapSize バイトをマップします。 次に、 メソッドは MapSize で指定されたバイト数の DMA 転送を開始します。
このメソッドの詳細については、「 IDmaChannel::BufferSize 」および 「IDmaChannelSlave::ReadCounter」を参照してください。
要件
要件 | 値 |
---|---|
Header | portcls.h |
IRQL | PASSIVE_LEVEL |