Partilhar via

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

  • Artigo

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ção DxgiDdiAddDevice .

hMemoryBasis

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

Retornar valor

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 Observações.

Comentários

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

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

Requisitos

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

Confira também

DxgkDdiCreateMemoryBasis