DXGKCB_INVALIDATEHWCONTEXT回呼函式 （d3dkmddi.h）

內核模式圖形驅動程式 （KMD） 會呼叫 DxgkcbInvalidatehwcontext 來使硬體內容失效。

語法

DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;

NTSTATUS DxgkcbInvalidatehwcontext(
  [in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}

參數

[in] unnamedParam1

DXGKARGCB_INVALIDATEHWCONTEXT 結構的指標，其中包含用來使硬體內容失效之 Dxgkrnl 的資訊。

傳回值

如果作業成功，DxgkcbInvalidatehwcontext 會傳回STATUS_SUCCESS。 否則，它會傳回適當的NTSTATUS錯誤碼。

言論

KMD 會呼叫 DxgkcbInvalidatehwcontext，以在與硬體內容相關聯的狀態和資源不再有效或一致時通知系統，因此需要重設或重新初始化內容，才能再次使用。 發生硬體引擎重設作業時，內容必須失效，原因可能是因為各種原因，例如從錯誤復原或重新設定 GPU 資源。

Dxgkrnl 會將內容標示為無效，使其不再排程在 GPU 上執行。 然後，它會起始任何必要的清除，例如釋放與內容相關聯的資源，或重設與內容相關聯的任何狀態。

DXGKCB_XXX 函式是由 Dxgkrnl實作。 若要使用此回呼函式，請設定 DXGKARGCB_INVALIDATEHWCONTEXT 的成員，然後透過 DXGKRNL_INTERFACE呼叫 DxgkCbInvalidateHwContext 。

要求

另請參閱

DXGKARGCB_INVALIDATEHWCONTEXT

DXGKRNL_INTERFACE