DXGKDDI_CREATEDEVICE función de devolución de llamada (d3dkmddi.h)

La función DXGKDDI_CREATEDEVICE crea un dispositivo de contexto gráfico que se usa posteriormente en llamadas a las funciones específicas del dispositivo del controlador de miniporte de pantalla.

Sintaxis

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

NTSTATUS DxgkddiCreatedevice(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}

Parámetros

hAdapter

[in] Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de miniporte de pantalla proporcionó anteriormente este identificador a Dxgkrnl en el parámetro de salida MiniportDeviceContext de la función DXGKDDI_ADD_DEVICE .

pCreateDevice

[in/out] Puntero a una estructura de DXGKARG_CREATEDEVICE que describe el dispositivo de contexto de gráficos.

Valor devuelto

DXGKDDI_CREATEDEVICE devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	DXGKDDI_CREATEDEVICE creó correctamente el dispositivo de contexto de gráficos.
STATUS_NO_MEMORY	DXGKDDI_CREATEDEVICE no pudo asignar memoria necesaria para que se complete.

Comentarios

Dxgkrnl llama a la función de DXGKDDI_CREATEDEVICE del controlador de minipuerto de pantalla para crear un dispositivo de contexto gráfico que el subsistema de gráficos pasa posteriormente llamadas al controlador de minipuerto de pantalla. El controlador usa un dispositivo para contener una colección de estado de representación. El subsistema de gráficos puede crear varios dispositivos en el mismo proceso en un adaptador de unidad de procesamiento de gráficos (GPU) determinado.

Nota

El número de dispositivos que pueden existir simultáneamente solo está limitado por la memoria del sistema disponible. Es decir, un controlador no puede tener un límite máximo codificado de forma rígida.

Por lo general, los dispositivos son independientes entre sí; es decir, los recursos creados en un dispositivo no pueden hacer referencia a los recursos creados en otro dispositivo ni acceder a ellos. Sin embargo, los recursos entre procesos son una excepción a esta regla.

DXGKDDI_CREATEDEVICE 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_CREATEDEVICE

DXGKDDI_ADD_DEVICE