PGET_DMA_ALIGNMENT コールバック関数 (wdm.h)
GetDmaAlignment ルーチンは、DMA システムのアラインメント要件を返します。
構文
PGET_DMA_ALIGNMENT PgetDmaAlignment;
ULONG PgetDmaAlignment(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
パラメーター
[in] DmaAdapter
バス マスター アダプターまたは DMA コントローラー 表す IoGetDmaAdapter によって返される DMA_ADAPTER 構造体へのポインター。
戻り値
GetDmaAlignment は、DMA システムのアラインメント要件をバイト単位で返します。 DMA バッファーの開始アドレスと長さは、この値の倍数である必要があります。
備考
GetDmaAlignment は、名前で直接呼び出すことができるシステム ルーチンではありません。 このルーチンは、DMA_OPERATIONS 構造体で返されたアドレスからのポインターによってのみ呼び出されます。 ドライバーは、IoGetDmaAdapterを呼び出すことによって、このルーチンのアドレスを取得します。
ドライバーは、割り当てる DMA バッファーの配置要件を決定するには、このルーチンを呼び出すことができます。 返される値は、デバイス オブジェクトの AlignmentRequirement フィールドを設定するために使用する必要があります。 ドライバーは、ハードウェア デバイスの追加の制限のため、この値を増やす必要があります。 詳細については、「デバイス オブジェクトの初期化」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 以降で使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | IrqlDispatch(wdm) |
関連項目
IoGetDmaAdapter の