PFND3DDDI_CREATEDEVICE función de devolución de llamada (d3dumddi.h)

La función CreateDevice crea un contexto de gráficos al que se hace referencia en llamadas posteriores.

Sintaxis

PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;

HRESULT Pfnd3dddiCreatedevice(
  HANDLE hAdapter,
  D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}

Parámetros

hAdapter

Identificador que identifica el adaptador de gráficos.

unnamedParam2

pCreateData [in, out]

Puntero a una estructura de D3DDDIARG_CREATEDEVICE . En la entrada, esta estructura contiene información que el controlador puede usar. En la salida, el controlador especifica información en la estructura que puede usar el entorno de ejecución de Microsoft Direct3D.

Valor devuelto

CreateDevice devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	El contexto de gráficos se crea correctamente.
E_OUTOFMEMORY	CreateDevice no pudo asignar la memoria necesaria para que se complete.

Comentarios

Un dispositivo de visualización es un contexto de gráficos que se usa para contener una colección de estado de representación. Varios dispositivos se pueden crear mediante el mismo proceso en un adaptador determinado. Tenga en cuenta que el número de dispositivos de visualización que pueden existir simultáneamente solo está limitado por la memoria del sistema disponible. Es decir, un controlador no puede codificar de forma dura un límite máximo de dispositivos.

Por lo general, los dispositivos son independientes entre sí, de modo que los recursos creados en un dispositivo no puedan hacer referencia a los recursos creados en otro. Sin embargo, los recursos entre procesos son una excepción a esta regla.

Cuando el tiempo de ejecución de Direct3D llama a CreateDevice para crear un dispositivo, el tiempo de ejecución no crea un subproceso de contexto de unidad de procesamiento gráfico (GPU) predeterminado para el dispositivo. El controlador debe llamar explícitamente a la función pfnCreateContextCb para crear uno o varios contextos según sea necesario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice