PFND3DDDI_GETCAPS función de devolución de llamada (d3dumddi.h)
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |