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 para Dxgkrnl en el MiniportDeviceContext parámetro de salida de la función DxgiDdiAddDevice.
pCreateDevice
[in/out] Puntero a una estructura de DXGKARG_CREATEDEVICE que describe el dispositivo de contexto gráfico.
Valor devuelto
DXGKDDI_CREATEDEVICE devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | DXGKDDI_CREATEDEVICE crear correctamente el dispositivo de contexto gráfico. |
| STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE no se pudo asignar memoria necesaria para que se complete. |
Observaciones
Dxgkrnl llama a la función DXGKDDI_CREATEDEVICE del controlador de miniporte para mostrar 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 de dispositivos codificado de forma rígida.
Por lo general, los dispositivos son independientes entre sí; es decir, los recursos creados en un dispositivo no se pueden hacer referencia a ellos ni acceder a ellos mediante recursos creados en otro dispositivo. Sin embargo, los recursos entre procesos son una excepción a esta regla.
DXGKDDI_CREATEDEVICE se debe hacer paginable.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h |
| irQL | PASSIVE_LEVEL |