DXGKDDI_DESTROYMEMORYBASIS função de retorno de chamada (d3dkmddi.h)

Artigo
02/06/2025

A função DxgkDdiDestroyMemoryBasis do KMD destrói uma base de memória criada por uma chamada anterior para DxgkDdiCreateMemoryBasis.

Sintaxe

DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;

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

Parâmetros

hAdapter

[in] Um identificador para um bloco de contexto associado a um adaptador de exibição. O KMD forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da funçãoDxgiDdiAddDevice.

hMemoryBasis

Manipule até a base de memória a ser destruída. Esse identificador foi criado anteriormente por uma chamada para DxgkDdiCreateMemoryBasis.

Valor de retorno

DxgkDdiDestroyMemoryBasis retornará STATUS_SUCCESS se a base de memória tiver sido destruída com êxito. Caso contrário, ele retornará um código de erro NTSTATUS. Consulte Comentários.

Observações

Dxgkrnl interpreta qualquer NTSTATUS retornado que não seja STATUS_SUCCESS como um retorno de notificação de erro catastrófico. Não deve haver um caminho de funcionamento correto para retornar nada além do sucesso dessa função, pois deve ser uma invariável presumida que o identificador fornecido seja aquele que foi criado e ainda não foi destruído. Se o KMD detectar entrada incorreta, um código de erro retornado permitirá Dxgkrnl atribuir a falha invariável ao kernel do sistema operacional em vez de uma falha de driver.

Para obter mais informações, consulte de controle de bits sujo .

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 11, versão 24H2 (WDDM 3.2)
cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Consulte também

DxgkDdiCreateMemoryBasis

Compartilhar via