IPortWaveCyclic::NewMasterDmaChannel メソッド (portcls.h)
NewMasterDmaChannel メソッドは、バス マスター DMA チャネルの新しいインスタンスを作成します。
構文
NTSTATUS NewMasterDmaChannel(
[out] PDMACHANNEL *DmaChannel,
[in] PUNKNOWN OuterUnknown,
[in, optional] PRESOURCELIST ResourceList,
[in] ULONG MaximumLength,
[in] BOOLEAN Dma32BitAddresses,
[in] BOOLEAN Dma64BitAddresses,
[in] DMA_WIDTH DmaWidth,
[in] DMA_SPEED DmaSpeed
);
パラメーター
[out] DmaChannel
メソッドが新しい IDmaChannel オブジェクトへのポインターを書き込む呼び出し元によって割り当てられたポインター変数へのポインター。 このパラメーターに有効な、以外の NULL ポインター値を指定します。
[in] OuterUnknown
IUnknown DMA チャネル オブジェクトを集計する必要があるオブジェクトのインターフェイスへのポインター。 このパラメーターは省略可能です。 集計が必要ない場合は、このパラメーター NULLとして指定します。
[in, optional] ResourceList
ミニポート ドライバーのリソース一覧へのポインター。IResourceList オブジェクト です。 このパラメーターは省略可能であり、NULLとして指定できます。 現在、NewMasterDmaChannel メソッドでは、このパラメーターは使用されません。
[in] MaximumLength
このチャネルに関連付けられる循環 DMA バッファーの最大長 (バイト単位)。
[in] Dma32BitAddresses
32 ビット アドレスの使用を指定します。
[in] Dma64BitAddresses
64 ビット アドレスの使用を指定します。
[in] DmaWidth
使用されません。 (DMA_WIDTH)(-1) に設定します。
[in] DmaSpeed
使用されません。 (DMA_SPEED)(-1) に設定します。
戻り値
NewMasterDmaChannel は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。
備考
パラメーター MaximumLength、Dma32BitAddresses、Dma64BitAddresses、DmaWidth、および DmaSpeed は、同じ名前の DEVICE_DESCRIPTION 構造体のメンバーと同様です。
バス マスタリング DMA ハードウェアが組み込まれた WaveCyclic デバイスは、マスター デバイスと呼ばれます。 これに対し、下位デバイス には DMA ハードウェアがないため、システム DMA コントローラーに依存して必要なデータ転送を実行する必要があります。
NewMasterDmaChannel メソッドは、マスター デバイスの DMA チャネル オブジェクトを作成します。 下位デバイスの DMA チャネル オブジェクトを作成するには、代わりに IPortWaveCyclic::NewSlaveDmaChannel メソッドを呼び出します。 マスター デバイスと下位デバイスの詳細については、IDmaChannel と IDmaChannelSlave のを参照してください。
DmaChannel、outerUnknown、および ResourceList パラメーターは、COM オブジェクト の参照カウント規則に従います。
手記
Microsoft では、多様で包括的な環境をサポートしています。 この記事には、偏りのない通信の Microsoft スタイル ガイドで除外として認識 用語への参照が含まれています。 単語または語句は、現在ソフトウェアに表示されるため、一貫性を保つため、この記事で使用されます。 言語を削除するようにソフトウェアが更新されると、この記事は整合するように更新されます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | portcls.h (Portcls.h を含む) |
| IRQL | PASSIVE_LEVEL |
関連項目
IPortWaveCyclic::NewSlaveDmaChannel
IResourceList の