DXGKCB_OPENPHYSICALMEMORYOBJECT回呼函式 (d3dkmddi.h)

發行項
02/23/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。