estructura D3DDDIARG_OPENADAPTER (d3dumddi.h)

  • Artículo

La estructura D3DDDIARG_OPENADAPTER contiene información que describe el objeto de adaptador de gráficos.

Sintaxis

typedef struct _D3DDDIARG_OPENADAPTER {
  [in/out] HANDLE                        hAdapter;
  [in]     UINT                          Interface;
  [in]     UINT                          Version;
  [in]     const D3DDDI_ADAPTERCALLBACKS *pAdapterCallbacks;
  [out]    D3DDDI_ADAPTERFUNCS           *pAdapterFuncs;
  [out]    UINT                          DriverVersion;
} D3DDDIARG_OPENADAPTER;

Miembros

[in/out] hAdapter

Identificador del objeto de adaptador de gráficos. En la entrada de la función OpenAdapter , hAdapter especifica el identificador que el controlador debe usar para consultar las funcionalidades del adaptador de gráficos cuando el controlador llama a la función de devolución de llamada pfnQueryAdapterInfoCb proporcionada por el entorno de ejecución de Microsoft Direct3D.

El controlador genera un identificador único y lo pasa de nuevo al tiempo de ejecución de Direct3D. En la salida de la función OpenAdapter , hAdapter especifica el identificador que el tiempo de ejecución de Direct3D usa en llamadas de controlador posteriores para identificar el objeto de adaptador de gráficos.

[in] Interface

La versión de la interfaz Direct3D/DirectDraw (por ejemplo, 7, 8 o 9) que abre el adaptador de gráficos.

[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 tiempo de ejecución que se publica con Windows Vista y un entorno de ejecución que se publica con un Service Pack posterior, que podría contener una corrección que requiere el controlador.

[in] pAdapterCallbacks

Puntero a una estructura de D3DDDI_ADAPTERCALLBACKS que contiene la función de devolución de llamada pfnQueryAdapterInfoCb proporcionada por el entorno de ejecución de Direct3D que el controlador puede usar.

[out] pAdapterFuncs

Puntero a una estructura de D3DDDI_ADAPTERFUNCS que contiene una tabla de funciones específicas del adaptador de controlador de pantalla en modo de usuario. El entorno de ejecución de Direct3D usa estas funciones para comunicarse con el controlador de visualización en modo de usuario sobre las operaciones específicas del adaptador de gráficos.

[out] DriverVersion

La versión de la interfaz del controlador de pantalla del modo de usuario de Direct3D, que se obtuvo del archivo de encabezado D3dumddi.h , con la que se compiló el controlador. El controlador de pantalla en modo de usuario debe devolver D3D_UMD_INTERFACE_VERSION.

Nota Si un controlador en modo de usuario no admite características de Windows 7 (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) y quiere compilar el controlador con windows 7 WDK (versión 7600), asegúrese de que el controlador devuelve D3D_UMD_INTERFACE_VERSION_VISTA.
 

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

D3DDDI_ADAPTERCALLBACKS

D3DDDI_ADAPTERFUNCS

OpenAdapter

pfnQueryAdapterInfoCb