DXGKCB_ENUMHANDLECHILDREN función de devolución de llamada (d3dkmddi.h)
DXGKCB_ENUMHANDLECHILDREN enumera las asignaciones asociadas a un recurso determinado, una asignación cada vez.
Sintaxis
DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;
D3DKMT_HANDLE DxgkcbEnumhandlechildren(
[in] IN_CONST_PDXGKARGCB_ENUMHANDLECHILDREN unnamedParam1
)
{...}
Parámetros
[in] unnamedParam1
Puntero a una estructura de DXGKARGCB_ENUMHANDLECHILDREN que describe el recurso primario y el índice de la asignación secundaria que se va a recuperar.
Valor devuelto
DXGKCB_ENUMHANDLECHILDREN devuelve el identificador específico de Dxgkrnl a la asignación secundaria que describe pData . Para recuperar los datos específicos del dispositivo para el identificador, el controlador de minipuerto de pantalla debe llamar a la función DXGKCB_GETHANDLEDATA .
DXGKCB_ENUMHANDLECHILDREN devuelve un identificador NULL si el valor del índice de asignación secundario proporcionado en el miembro Index de la estructura DXGKARGCB_ENUMHANDLECHILDREN supera el número de asignaciones asociadas al recurso primario. Si DXGKCB_ENUMHANDLECHILDREN devuelve inesperadamente un identificador NULL, el subsistema del kernel de gráficos de DirectX no pudo resolver el identificador para el recurso primario, por un motivo como las siguientes posibilidades:
- Se recibió un identificador no válido del controlador de pantalla en modo de usuario debido a un ataque malintencionado o a algún otro error.
- Las asignaciones tenían problemas de duración.
Si un identificador NULL se devuelve inesperadamente, el controlador de miniporte de pantalla debe producir un error en su función DDI que se está ejecutando actualmente con STATUS_INVALID_HANDLE.
Comentarios
Un controlador de minipuerto de pantalla puede llamar a DXGKCB_ENUMHANDLECHILDREN en un bucle para enumerar todas las asignaciones asociadas a un recurso.
Los índices de identificadores de asignación se basan en cero. Si el controlador de minipuerto de pantalla establece pData-Index> en 0, DXGKCB_ENUMHANDLECHILDREN devuelve el primer identificador de asignación; si Index está establecido en 1, DXGKCB_ENUMHANDLECHILDREN devuelve el segundo identificador de asignación; etc. Si Index es mayor que el número de asignaciones asociadas al recurso, DXGKCB_ENUMHANDLECHILDREN devuelve NULL.
Dxgkrnl implementa DXGKCB_XXX funciones. Para usar esta función de devolución de llamada, establezca los miembros adecuados de DXGKARGCB_ENUMHANDLECHILDREN y, a continuación, llame a DxgkCbEnumHandleChildren a través del DXGKRNL_INTERFACE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista (WDDM 1.0) |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |