PFND3DDDI_CREATECONTEXTCB función de devolución de llamada (d3dumddi.h)
El entorno de ejecución de Direct3D pfnCreateContextCb función de devolución de llamada crea un contexto.
Sintaxis
PFND3DDDI_CREATECONTEXTCB Pfnd3dddiCreatecontextcb;
HRESULT Pfnd3dddiCreatecontextcb(
HANDLE hDevice,
D3DDDICB_CREATECONTEXT *unnamedParam2
)
{...}
Parámetros
hDevice
[in] Controle al dispositivo para el que se va a crear el contexto.
unnamedParam2
[in/out] Puntero a una estructura de D3DDDICB_CREATECONTEXT que el controlador rellena con la información necesaria para crear el contexto. Esta estructura incluye detalles como el ordinal de nodo, la afinidad del motor y las marcas que especifican el comportamiento y las funcionalidades del contexto que se va a crear. Tras la finalización correcta, el tiempo de ejecución actualiza esta estructura con información sobre el contexto recién creado.
Valor devuelto
pfnCreateContextCb devuelve un VALOR HRESULT para indicar el éxito o error de la solicitud de creación de contexto. Entre los valores devueltos comunes se incluyen:
| Código devuelto | Significado |
|---|---|
| S_OK | El contexto se creó correctamente. |
| E_OUTOFMEMORY | No hay memoria suficiente para crear el contexto. |
| E_INVALIDARG | Uno o varios de los argumentos proporcionados no son válidos. |
Observaciones
El controlador de pantalla en modo de usuario (UMD) debe llamar explícitamente a pfnCreateContextCb desde su implementación de CreateDevice para crear un contexto de GPU asociado al dispositivo. Los contextos de GPU son subprocesos de GPU de ejecución en un dispositivo recién creado.
El contexto encapsula los búferes de estado y comandos que usa la GPU para realizar operaciones de representación. UMD es responsable de administrar el ciclo de vida de los contextos que crea, incluida su eventual destrucción para liberar recursos.
Para obtener más información sobre la creación de un dispositivo de representación, consulta flujo de operación del modelo de controladores de pantalla de Windows (WDDM).
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista (WDDM 1.0) |
| encabezado de |
d3dumddi.h |
Consulte también
pfnDestroyContextCb de