estructura D3DDDIARG_CREATEDEVICE (d3dumddi.h)

  • Artículo

La estructura D3DDDIARG_CREATEDEVICE contiene información que describe el dispositivo para mostrar que se va a crear.

Sintaxis

typedef struct _D3DDDIARG_CREATEDEVICE {
  [in/out] HANDLE                       hDevice;
  [in]     UINT                         Interface;
  [in]     UINT                         Version;
  [in]     const D3DDDI_DEVICECALLBACKS *pCallbacks;
  [in]     VOID                         *pCommandBuffer;
  [in]     UINT                         CommandBufferSize;
  [in]     D3DDDI_ALLOCATIONLIST        *pAllocationList;
  [in]     UINT                         AllocationListSize;
  [in]     D3DDDI_PATCHLOCATIONLIST     *pPatchLocationList;
  [in]     UINT                         PatchLocationListSize;
           D3DDDI_DEVICEFUNCS           *pDeviceFuncs;
  [in]     D3DDDI_CREATEDEVICEFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS       CommandBuffer;
} D3DDDIARG_CREATEDEVICE;

Miembros

[in/out] hDevice

Identificador del dispositivo de visualización (contexto de gráficos). En la entrada de la función CreateDevice , hDevice especifica el identificador que el controlador debe usar cuando vuelve a llamar al tiempo de ejecución de Microsoft Direct3D.

El controlador genera un identificador único y lo pasa al tiempo de ejecución de Direct3D. En la salida de la función CreateDevice , hDevice especifica el identificador que el tiempo de ejecución de Direct3D usa en las llamadas de controlador posteriores para identificar el dispositivo de visualización.

[in] Interface

La versión de la interfaz Direct3D/DirectDraw (por ejemplo, 7, 8 o 9) que crea el dispositivo.

[in] Version

Número que el controlador puede usar para identificar cuándo se creó el entorno de ejecución de Direct3D/DirectDraw. Por ejemplo, el controlador puede usar el número de versión para diferenciar entre un entorno de ejecución que se publica con Windows Vista y un entorno de ejecución que se publica con un Service Pack posterior, que puede contener una corrección que requiere el controlador.

[in] pCallbacks

Puntero a una estructura de D3DDDI_DEVICECALLBACKS que contiene una tabla de funciones de devolución de llamada en tiempo de ejecución de Direct3D que el controlador puede usar.

[in] pCommandBuffer

Obsoleto. Para recibir un puntero al primer búfer que el controlador de pantalla en modo de usuario puede usar para los comandos por lotes, el controlador primero debe llamar a la función pfnCreateContextCb para crear un contexto para el dispositivo recién creado.

[in] CommandBufferSize

Obsoleto.

[in] pAllocationList

Obsoleto. Para recibir una matriz de estructuras de D3DDDI_ALLOCATIONLIST para la lista de asignación inicial, el controlador primero debe llamar a la función pfnCreateContextCb para crear un contexto para el dispositivo recién creado.

[in] AllocationListSize

Obsoleto.

[in] pPatchLocationList

Obsoleto. Para recibir una matriz de estructuras de D3DDDI_PATCHLOCATIONLIST para la lista de ubicación de revisión inicial, el controlador primero debe llamar a la función pfnCreateContextCb para crear un contexto para el dispositivo recién creado.

[in] PatchLocationListSize

Obsoleto.

pDeviceFuncs

[out] Puntero a una estructura de D3DDDI_DEVICEFUNCS que el controlador de visualización en modo de usuario rellena con una tabla de sus funciones. El tiempo de ejecución de Direct3D usa estas funciones para comunicarse con el controlador de pantalla en modo de usuario.

[in] Flags

Estructura D3DDDI_CREATEDEVICEFLAGS que identifica cómo crear el dispositivo.

CommandBuffer

Este miembro está reservado y debe establecerse en cero.

Este miembro está disponible a partir de Windows 7.

Requisitos

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

Consulte también

CreateDevice

D3DDDI_CREATEDEVICEFLAGS

D3DDDI_DEVICECALLBACKS

D3DDDI_DEVICEFUNCS

DxgkDdiCreateDevice