DXGKCB_ENUMHANDLECHILDREN função de retorno de chamada (d3dkmddi.h)
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 |