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

このコールバック関数は、ドメイン共通バッファーにメモリを割り当てます。

構文

PALLOCATE_DOMAIN_COMMON_BUFFER PallocateDomainCommonBuffer;

NTSTATUS PallocateDomainCommonBuffer(
  [in]           PDMA_ADAPTER DmaAdapter,
  [in]           HANDLE DomainHandle,
  [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,
  [out]          PVOID *VirtualAddress
)
{...}

パラメーター

[in] DmaAdapter

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

[in] DomainHandle

呼び出し元が前の呼び出しから取得した DMA ドメインへのハンドル PGET_DMA_DOMAIN。

[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 などのルーチンによって返される物理アドレスではなく、この論理アドレスを使用する必要があります。

[out] VirtualAddress

このルーチンが割り当てられたバッファーの対応する仮想アドレスを書き込む変数へのポインター。

戻り値

呼び出しが成功した場合は、STATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS 値を返します。

要件

要件	値
サポートされている最小のクライアント	Windows 10
Header	wdm.h (Wdm.h を含む)
IRQL	PASSIVE_LEVEL