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

Artículo
02/26/2024

El tiempo de ejecución D3D llama a la función de devolución de llamada PFND3DDDI_GETCAPS del controlador para consultar las funcionalidades del adaptador de gráficos.

Sintaxis

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

Parámetros

hAdapter

Identificador que identifica el adaptador de gráficos.

unnamedParam2

pData [in, out]

Puntero a una estructura de D3DDDIARG_GETCAPS que describe las funcionalidades que se van a recuperar.

Valor devuelto

PFND3DDDI_GETCAPS devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	Las funcionalidades se recuperaron correctamente.
E_OUTOFMEMORY	PFND3DDDI_GETCAPS no pudo asignar la memoria necesaria para que se complete.

Comentarios

Los datos devueltos en el miembro pData de la estructura D3DDDIARG_GETCAPS dependen del tipo de datos solicitados (es decir, los datos dependen de D3DDDIARG_GETCAPS. Escriba y, a veces, en el miembro pInfo ).

En la tabla siguiente se muestran dos ejemplos de cómo configurar la llamada PFND3DDDI_GETCAPS en función del valor de D3DDDIARG_GETCAPS. Tipo.

D3DDDIARG_GETCAPS miembro	Ejemplo 1	Ejemplo 2
Tipo	D3DDDICAPS_DDRAW	D3DDDICAPS_GETFORMATCOUNT
pInfo	[in] NULL (no se establecen condiciones)	[in] NULL (no se establecen condiciones)
pData	[out] DDRAW_CAPS (puntero único)	[out] UINT* (puntero único)
DataSize	sizeof(DDRAW_CAPS)	sizeof(UINT)
Notas	El controlador debe rellenar la estructura DDRAW_CAPS con las funcionalidades de DirectDraw que admite.	El controlador debe rellenar el búfer al que apunta pData con un valor UINT que represente el número de formatos de superficie D3DDDIFORMAT que admite el dispositivo.

Consulte D3DDDIARG_GETCAPS para obtener explicaciones de otros valores para D3DDDIARG_GETCAPS. Tipo que se usa para superposiciones multiplano.

Simple_instancing

Si un controlador de Nivel 9 de Direct3D que admite Windows Display Driver Model (WDDM) 1.3 y versiones posteriores completa una llamada a PFND3DDDI_GETCAPS y devuelve S_OK pero no cambia los datos de la estructura D3DDDIARG_GETCAPS , indica al tiempo de ejecución de Direct3D que el hardware y el controlador no admiten la creación de instancias simples. Para obtener más información, consulta D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.