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

  • Artigo

DXGKCB_ENUMHANDLECHILDREN enumera as alocações associadas a um determinado recurso, uma alocação por vez.

Sintaxe

DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;

D3DKMT_HANDLE DxgkcbEnumhandlechildren(
  [in] IN_CONST_PDXGKARGCB_ENUMHANDLECHILDREN unnamedParam1
)
{...}

Parâmetros

[in] unnamedParam1

Ponteiro para uma estrutura DXGKARGCB_ENUMHANDLECHILDREN que descreve o recurso pai e o índice da alocação filho a ser recuperada.

Retornar valor

DXGKCB_ENUMHANDLECHILDREN retorna o identificador específico de Dxgkrnl para a alocação filho que pData descreve. Para recuperar os dados específicos do dispositivo para o identificador, o driver de miniporta de exibição deve chamar a função DXGKCB_GETHANDLEDATA .

DXGKCB_ENUMHANDLECHILDREN retornará um identificador NULL se o valor do índice de alocação filho fornecido no membro Index da estrutura DXGKARGCB_ENUMHANDLECHILDREN exceder o número de alocações associadas ao recurso pai. Se DXGKCB_ENUMHANDLECHILDREN retornar inesperadamente um identificador NULL, o subsistema de kernel de elementos gráficos DirectX 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 inesperadamente, 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

Um driver de miniporta de exibição pode chamar DXGKCB_ENUMHANDLECHILDREN em um loop para enumerar todas as alocações associadas a um recurso.

Os índices do identificador de alocação são baseados em zero. Se o driver de miniporta de exibição definir pData-Index> como 0, DXGKCB_ENUMHANDLECHILDREN retornará o primeiro identificador de alocação; se Index estiver definido como 1, DXGKCB_ENUMHANDLECHILDREN retornará o segundo identificador de alocação e assim por diante. Se Index for maior que o número de alocações associadas ao recurso, DXGKCB_ENUMHANDLECHILDREN retornará NULL.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina os membros apropriados do DXGKARGCB_ENUMHANDLECHILDREN e, em seguida, chame DxgkCbEnumHandleChildren 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 PASSIVE_LEVEL

Confira também

DXGKARGCB_ENUMHANDLECHILDREN

DXGKCB_GETHANDLEDATA

DXGKRNL_INTERFACE