Compartir a través de


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 minipuerto de pantalla proporcionó anteriormente este identificador a Dxgkrnl en el parámetro de salida MiniportDeviceContext de la función DxgiDdiAddDevice .

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 ha creado correctamente el dispositivo de contexto de gráficos.
STATUS_NO_MEMORY DXGKDDI_CREATEDEVICE no pudo asignar memoria necesaria para que se completara.

Comentarios

Dxgkrnl llama a la función DXGKDDI_CREATEDEVICE del controlador de minipuerto de pantalla para crear un dispositivo de contexto de gráficos que el subsistema de gráficos pasa posteriormente llamadas al controlador de miniporte 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 gráfico (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 de dispositivos codificados 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 que se crean 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