DXGKDDI_DESTROYMEMORYBASIS回呼函式 (d3dkmddi.h)

KMD 的 DxgkDdiDestroyMemoryBasis 函式會終結先前呼叫 DxgkDdiCreateMemoryBasis 所建立的記憶體基礎。

語法

DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;

NTSTATUS DxgkddiDestroymemorybasis(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

參數

hAdapter

[in]與顯示配接器相關聯的內容區塊句柄。 KMD 先前在 DxgiDdiAddDevice 函式的 MiniportDeviceContext 輸出參數中，將此句柄提供給 Dxgkrnl。

hMemoryBasis

要終結的記憶體基礎句柄。 此句柄先前是由呼叫 DxgkDdiCreateMemoryBasis 所建立。

傳回值

如果已成功終結記憶體基礎，DxgkDdiDestroyMemoryBasis 會傳回STATUS_SUCCESS。 否則，它會傳回NTSTATUS錯誤碼。 請參閱＜備註＞。

備註

Dxgkrnl 會將未STATUS_SUCCESS的任何傳回NTSTATUS解譯為重大錯誤通知傳回。 應該沒有正確運作的路徑可傳回此函式以外的任何專案，因為它應該是假設提供的句柄是已建立且尚未終結的句柄。 如果 KMD 偵測到不正確的輸入，傳回的錯誤碼可讓 Dxgkrnl 將不變異失敗指派給 OS 核心，而不是驅動程式損毀。

如需詳細資訊，請參閱 Dirty 位追蹤。

規格需求

另請參閱

DxgkDdiCreateMemoryBasis