DXGKCB_GETHANDLEPARENT função de retorno de chamada (d3dkmddi.h)
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.
Valor de retorno
DXGKCB_GETHANDLEPARENT retorna um identificador específico do subsistema gráfico para o recurso pai para a alocação associada ao identificador que o parâmetro hAllocation especifica.
Se DXGKCB_GETHANDLEPARENT retornar um identificador NULL, Dxgkrnl.sys não foi possível resolver 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 tinham problemas de tempo de vida.
Se uma alça NULL for retornada, o driver de miniporto de exibição deverá falhar em sua função DDI em execução no momento com STATUS_INVALID_HANDLE.
Observações
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 retorna 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 |
|---|---|
| de cliente com suporte mínimo | Windows Vista (WDDM 1.0) |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | < DISPATCH_LEVEL |