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