Compartilhar via

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

  • Artigo

DXGKCB_GETHANDLEPARENT recupera o recurso pai da alocação especificada.

Sintaxe

DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;

D3DKMT_HANDLE DxgkcbGethandleparent(
  [in] IN_D3DKMT_HANDLE hAllocation
)
{...}

Parâmetros

[in] hAllocation

Um identificador para uma alocação. Esse identificador deve ser o identificador do modo kernel que o subsistema de kernel de elementos gráficos DirectX (Dxgkrnl.sys) atribuiu para a alocação.

Retornar valor

DXGKCB_GETHANDLEPARENT retorna um identificador específico do subsistema gráfico para o recurso pai para a alocação associada ao identificador especificado pelo parâmetro hAllocation .

Se DXGKCB_GETHANDLEPARENT retornar um identificador NULL, Dxgkrnl.sys não pôde resolve o identificador para o recurso pai por um motivo como as seguintes possibilidades:

  • Um identificador inválido foi recebido do driver de exibição do modo de usuário devido a um ataque mal-intencionado ou algum outro bug.
  • As alocações tiveram problemas de tempo de vida.

Se um identificador NULL for retornado, o driver de miniporto de exibição deverá falhar em sua função DDI em execução no momento com STATUS_INVALID_HANDLE.

Comentários

Para DXGKCB_GETHANDLEPARENT retornar um identificador de recurso, o identificador em hAllocation deve ser um identificador de alocação associado a um recurso; caso contrário, DXGKCB_GETHANDLEPARENT retornará NULL.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, chame DxgkCbGetHandleParent por meio do DXGKRNL_INTERFACE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista (WDDM 1.0)
Plataforma de Destino Área de Trabalho
Cabeçalho d3dkmddi.h (inclua D3dkmddi.h)
IRQL < DISPATCH_LEVEL

Confira também

DXGKRNL_INTERFACE