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 de DXGKARGCB_ENUMHANDLECHILDREN que descreve o recurso pai e o índice da alocação filho a ser recuperada.
Valor de retorno
DXGKCB_ENUMHANDLECHILDREN retorna o identificador específico do Dxgkrnl para a alocação filho que pData descreve. Para recuperar os dados específicos do dispositivo para o identificador, o driver de miniporto 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 Index membro 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 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 um identificador de 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.
Observações
Um driver de miniporto 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 miniporto de exibição definir pData->Index como 0, DXGKCB_ENUMHANDLECHILDREN retornará o primeiro identificador de alocação; se índice estiver definido como 1, DXGKCB_ENUMHANDLECHILDREN retornará o segundo identificador de alocação; e assim por diante. Se Índice for maior do 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 chame DxgkCbEnumHandleChildren 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 | PASSIVE_LEVEL |