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 |