IPortWaveRTStream::MapAllocatedPages メソッド (portcls.h)

[アーティクル]
08/07/2023

メソッドは MapAllocatedPages 、以前に割り当てられた物理ページの一覧を、カーネルモードからアクセスできる仮想メモリの連続したブロックにマップします。

構文

PVOID MapAllocatedPages(
  [in] PMDL                MemoryDescriptorList,
  [in] MEMORY_CACHING_TYPE CacheType
);

パラメーター

[in] MemoryDescriptorList

マップされるメモリ記述子リスト (MDL) へのポインター。 MDL は、 IPortWaveRTStream::AllocatePagesForMdl または IPortWaveRTStream::AllocateContiguousPagesForMdl を呼び出すことによって割り当てることができます。

[in] CacheType

キャッシュの種類を指定します。このパラメーターを、mmNonCached、MmCached、または MmWriteCombined のいずれかのMEMORY_CACHING_TYPE列挙値に設定します。

戻り値

MapAllocatedPages は、仮想メモリ内のマップされたバッファーの開始アドレスを返します。メソッドがバッファーをマップできない場合は、 NULL を返します。

注釈

Windows オーディオスタックではバッファーのメモリアクセスアラインメント要件を表すメカニズムがサポートされていないため、オーディオドライバーは、プラットフォーム固有のアラインメント要件を課さないマップされたメモリバッファーのキャッシュの種類を選択する必要があります。言い換えると、マップされたメモリバッファーに対してオーディオドライバーによって使用されるキャッシュの種類は、特定のプラットフォームのメモリアラインメント要件に関する仮定を行う必要はありません。

このメソッドは、MDL 内の物理メモリページをカーネルモードの仮想メモリにマップします。通常、ミニポートドライバーは、オーディオバッファーの散布図リストへのソフトウェアアクセスが必要な場合は、このメソッドを呼び出します。この場合、分散収集リストのストレージは 、IPortWaveRTStream::AllocatePagesForMdl メソッドまたは IPortWaveRTStream::AllocateContiguousPagesForMdl メソッドによって割り当 てられている必要があります。

WaveRT ミニポートドライバーでは、オーディオバッファー自体へのソフトウェアアクセスは必要ありません。

MapAllocatedPages は、 MmMapLockedPagesSpecifyCache 関数と同様の操作です。ミニポートドライバーは、解放する前にメモリのマップを解除する役割を担います。詳細については、「 IPortWaveRTStream::UnmapAllocatedPages」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降の Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	portcls.h
IRQL	パッシブレベル。