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

Artículo
02/26/2024

La función pfnGetMultisampleMethodListCb recupera una lista de métodos de ejemplo múltiples que se usan para el ancho, alto y formato de una asignación especificados.

Sintaxis

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

HRESULT Pfnd3dddiGetmultisamplemethodlistcb(
  HANDLE hAdapter,
  D3DDDICB_GETMULTISAMPLEMETHODLIST *unnamedParam2
)
{...}

Parámetros

hAdapter

Identificador del objeto del adaptador de gráficos.

unnamedParam2

pData [in, out]

Puntero a una estructura de D3DDDICB_GETMULTISAMPLEMETHODLIST que describe la lista de métodos de ejemplo múltiple para una asignación.

Valor devuelto

pfnGetMultisampleMethodListCb devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	La lista de métodos de ejemplo múltiple se recuperó correctamente.
E_INVALIDARG	Los parámetros se validaron y determinaron que son incorrectos.

Esta función también podría devolver otros valores HRESULT.

Comentarios

El controlador de pantalla en modo de usuario normalmente usa la función pfnGetMultisampleMethodListCb con su función CreateResource, CreateResource(D3D10) o CreateResource(D3D11) y la función pfnAllocateCb . El controlador usa pfnGetMultisampleMethodListCb cuando el tiempo de ejecución de Direct3D llama al createResource, CreateResource(D3D10) del controlador o CreateResource(D3D11) para solicitar que el controlador cree una principal de muestreo múltiple. El controlador también usa pfnGetMultisampleMethodListCb cuando debe realizar el muestreo múltiple mientras se examina desde la principal. Este tipo de muestreo múltiple puede consumir ancho de banda de memoria adicional, más allá del ancho de banda necesario para examinar el modo de presentación. Por lo tanto, pfnGetMultisampleMethodListCb consulta el administrador de modo de presentación (DMM) (e indirectamente el controlador de minipuerto de pantalla) para recuperar una lista de métodos de muestreo múltiple admitidos para el ancho, alto y formato especificados. Si pfnGetMultisampleMethodListCb informa de que no se admiten métodos, el controlador de pantalla en modo de usuario debe usar una versión sin examinar de muestreo múltiple, normalmente mediante la creación de un principal no muestreado nomultiple estándar.

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)