DXGKCB_OPENPHYSICALMEMORYOBJECT コールバック関数 (d3dkmddi.h)

[アーティクル]
02/26/2024

カーネルモードディスプレイミニポートドライバーは、物理メモリオブジェクトを開き、アダプターに関連付ける DXGKCB_OPENPHYSICALMEMORYOBJECT を呼び出します。

構文

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

NTSTATUS DxgkcbOpenphysicalmemoryobject(
  [in/out] IN_OUT_PDXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}

パラメーター

[in/out] pArgs

開く物理メモリオブジェクトに関する情報を含む DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT構造体への ポインター。

戻り値

DXGKCB_OPENPHYSICALMEMORYOBJECT は、操作が成功した場合にSTATUS_SUCCESSを返します。それ以外の場合は、適切な NTSTATUS エラーコードを返します。

注釈

物理メモリオブジェクトからアドレス記述子リスト (ADL) を作成するには、まずアダプターに関連付ける必要があります。これは通常、DXGKCB_CREATEPHYSICALMEMORYOBJECTの呼び出しで hAdapter パラメーターを指定して物理メモリオブジェクトを作成するときに行われます。 ただし、場合によっては、メモリが割り当てられた時点 (ブートプロセスの早い段階など) にアダプターハンドルを使用できない場合があります。この場合、ドライバーは DXGKCB_OPENPHYSICALMEMORYOBJECT を呼び出して、DXGKCB_ALLOCATEADL を呼び出す前に物理メモリオブジェクトをアダプターに関連付ける必要があります。

詳細については、「 IOMMU DMA の再マップ」を参照してください。

DXGKCB_XXX 関数は Dxgkrnl によって実装されます。このコールバック関数を使用するには、DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECTの適切なメンバーを設定し、DXGKRNL_INTERFACEを介して DxgkCbOpenPhysicalMemoryObject を呼び出します。