DXGKDDI_CREATECONTEXT función de devolución de llamada (d3dkmddi.h)
La función DxgkDdiCreateContext crea un contexto de unidad de procesamiento gráfico (GPU).
Sintaxis
DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;
NTSTATUS DxgkddiCreatecontext(
[in] IN_CONST_HANDLE hDevice,
[in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}
Parámetros
[in] hDevice
Identificador del dispositivo de contexto de gráficos en el que se crea el nuevo contexto. La función DxgkDdiCreateDevice del controlador de miniporte de pantalla proporcionó este identificador al subsistema del kernel de gráficos de Microsoft DirectX en el miembro hDevice de la estructura DXGKARG_CREATEDEVICE .
[in/out] pCreateContext
Puntero a una estructura de DXGKARG_CREATECONTEXT que contiene información sobre cómo crear el contexto.
Valor devuelto
DxgkDdiCreateContext devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | DxgkDdiCreateContext creó correctamente el contexto. |
| STATUS_NO_MEMORY | DxgkDdiCreateContext no pudo asignar memoria necesaria para que se complete. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | El controlador de miniporte de pantalla de pantalla no es compatible con el controlador de pantalla en modo de usuario que inició la llamada a DxgkDdiCreateContext. |
Comentarios
Un controlador usa un contexto de GPU para contener una colección de estado de representación.
Un único proceso puede crear varios contextos en un dispositivo determinado.
El controlador debe admitir un número arbitrario de contextos. La única razón válida por la que un controlador no pudo crear un contexto es si se agota la memoria del sistema.
Normalmente, cada contexto puede hacer referencia a cualquier recurso creado anteriormente para el dispositivo que posee ese contexto.
DxgkDdiCreateContext debe ser paginable.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |