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

Consulte también

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice