次の方法で共有

PALLOCATE_COMMON_BUFFER_WITH_BOUNDS コールバック関数 (wdm.h)

  • [アーティクル]

このコールバック関数は、共通バッファーにメモリを割り当て、マスター デバイスと CPU からアクセスできるようにマップします。 共通バッファーは、オプションの最小および最大論理アドレスでバインドできます。

構文

PALLOCATE_COMMON_BUFFER_WITH_BOUNDS PallocateCommonBufferWithBounds;

PVOID PallocateCommonBufferWithBounds(
  [in]           PDMA_ADAPTER DmaAdapter,
  [in, optional] PPHYSICAL_ADDRESS MinimumAddress,
  [in, optional] PPHYSICAL_ADDRESS MaximumAddress,
  [in]           ULONG Length,
  [in]           ULONG Flags,
  [in, optional] MEMORY_CACHING_TYPE *CacheType,
  [in]           NODE_REQUIREMENT PreferredNode,
  [out]          PPHYSICAL_ADDRESS LogicalAddress
)
{...}

パラメーター

[in] DmaAdapter

DMA_ADAPTER構造体へのポインター。 この構造体は、ドライバーのバス マスター DMA デバイスまたはシステム DMA チャネルを表すアダプター オブジェクトです。 呼び出し元は、IoGetDmaAdapter ルーチンへの以前の呼び出しからこのポインターを取得しました。

[in, optional] MinimumAddress

共通バッファーの最小論理アドレスを含む変数へのポインター。 このパラメーターは、このアドレス以降のメモリからバッファーを割り当てる必要があることを示します。 このパラメーターは省略可能であり、NULL として指定して、最小アドレスがないことを示すことができます。

[in, optional] MaximumAddress

共通バッファーの最大論理アドレスを含む変数へのポインター。 このパラメーターは、このアドレスより下のメモリからバッファーを割り当てる必要があることを示します。 このパラメーターは省略可能であり、最大アドレスがないことを示すために NULL として指定できます。

[in] Length

DMA 操作に割り当てられる共通バッファーのサイズ (バイト単位)。

[in] Flags

DMA 操作に割り当てられる共通バッファーのサイズ (バイト単位)。

旗 意味
DOMAIN_COMMON_BUFFER_LARGE_PAGE 共通バッファーは、PAGE_SIZE * 512 のより大きなページ細分性を使用して割り当てられます。 これにより、割り当てが失敗する可能性が高くなる可能性があることに注意してください。

[in, optional] CacheType

ルーチンが割り当てられる共通バッファー内のキャッシュされたメモリを有効または無効にする必要があるかどうかを示す MEMORY_CACHING_TYPE 列挙体へのポインター。 mmNonCached と MmCached の値のみがサポートされます。 このパラメーターは省略可能であり、NULL として指定して、キャッシュがハードウェア プラットフォームの既定値に依存することを指定できます。

[in] PreferredNode

メモリの割り当て元となる優先 NUMA ノード。 N がマルチプロセッサ システム内の NUMA ノードの数である場合、PreferredNode は 0 から N ~ 1 の範囲の数値になります。 1 プロセッサ システムまたは NUMA 以外のマルチプロセッサ システムの場合は、PreferredNode 0 に設定します。

[out] LogicalAddress

このルーチンが、デバイスが共通バッファーへのアクセスに使用できる論理アドレスを書き込む変数へのポインター。 DMA デバイスでは、mmGetPhysicalAddressなどのルーチンによって返される物理アドレスではなく、この論理アドレス使用する必要があります。

戻り値

共通バッファーに割り当てられたメモリの仮想アドレスである PVOID を返します。 バッファーを割り当てることができない場合は、NULL を返します。

備考

このコールバック関数は、PALLOCATE_COMMON_BUFFER_EX ルーチンの拡張バージョンです。 次の一覧は、拡張バージョンでのみ使用できる機能をまとめたものです。

  • 呼び出し元は、割り当てる共通バッファーの最小論理アドレスを指定できます。

  • 呼び出し元は、ハードウェア プラットフォームに関係なく従うキャッシュ型のオーバーライドを提供できます。

  • 呼び出し元は、一般的なバッファー割り当てに対して、より大きな粒度の使用を指定できます。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 1803
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h (Wdm.h を含む)
IRQL PASSIVE_LEVEL

関連項目

DMA_OPERATIONS

PALLOCATE_COMMON_BUFFER_EX