PFND3D10DDI_SETRENDERTARGETS función de devolución de llamada (d3d10umddi.h)
Las SetRenderTargets conjuntos de funciones de devolución de llamada representan las superficies de destino.
Sintaxis
PFND3D10DDI_SETRENDERTARGETS Pfnd3d10ddiSetrendertargets;
void Pfnd3d10ddiSetrendertargets(
[in] D3D10DDI_HDEVICE unnamedParam1,
[in] const D3D10DDI_HRENDERTARGETVIEW *unnamedParam2,
[in] UINT NumViews,
[in] UINT ClearSlots,
[in] D3D10DDI_HDEPTHSTENCILVIEW unnamedParam5
)
{...}
Parámetros
[in] unnamedParam1
hDevice: identificador del dispositivo de visualización (contexto gráfico).
[in] unnamedParam2
phRenderTargetView: matriz de identificadores para los objetos de vista de destino de representación que se van a establecer. Tenga en cuenta que algunos valores de identificador pueden ser NULL.
[in] NumViews
: número de elementos de la matriz que phRenderTargetView especifica.
[in] ClearSlots
Número de ranuras de destino de representación después del número de ranuras que NumViews especifica que se va a establecer en NULL. Este número representa la diferencia entre el número anterior de objetos de vista de destino de representación (es decir, cuando el tiempo de ejecución de Microsoft Direct3D anteriormente llamó a SetRenderTargets) y el nuevo número de objetos de vista de destino de representación.
Tenga en cuenta que el número que ClearTargets especifica es solo una ayuda de optimización porque el controlador de pantalla en modo de usuario podría calcular este número.
[in] unnamedParam5
hDepthStencilView: identificador de la vista de galería de símbolos de profundidad.
Valor devuelto
Ninguno
Observaciones
El controlador puede usar el pfnSetErrorCb función de devolución de llamada para establecer un código de error.
El controlador de visualización en modo de usuario debe establecer todas las superficies de destino de representación y el búfer de galería de símbolos de profundidad de forma atómica como una operación.
Aunque el parámetro NumViews especifica el número de identificadores de la matriz que especifica el parámetro phRenderTargetView , algunos valores de identificador de la matriz pueden ser NULL.
El intervalo de superficies de destino de representación entre el número que NumViews especifica y se requiere el número máximo de superficies de destino de representación permitidas para contener todos los valores null o sin enlazar. El número que especifica el parámetro ClearTargets informa al controlador sobre cuántos puntos de enlace debe borrar el controlador para la operación atómica actual.
Si la llamada anterior a SetRenderTargets pasó un valor de 2 en el parámetro NumViews y la llamada actual a SetRenderTargets pasa un valor de 4 en NumViews, la llamada actual a SetRenderTargets también pasa un valor de 0 en el parámetro ClearTargets. Si la siguiente llamada sucesiva a SetRenderTargets pasa un valor de 1 en NumViews, la llamada sucesiva también pasa un valor de 3 (4 - 1) en ClearTargets.
Cuando se solicita el valor de destinos claros durante las operaciones de consulta en modo de usuario, el valor es la diferencia entre el número máximo de superficies de destino de representación y el valor de los destinos de representación.
El controlador no debe encontrar ningún error, excepto D3DDDIERR_DEVICEREMOVED. Por lo tanto, si el controlador pasa algún error, excepto por D3DDDIERR_DEVICEREMOVED, en una llamada a la funciónpfnSetErrorCb, el tiempo de ejecución de Microsoft Direct3D determinará que el error es crítico. Incluso si se quitó el dispositivo, no es necesario que el controlador devuelva D3DDDIERR_DEVICEREMOVED; Sin embargo, si la eliminación de dispositivos interfirió con el funcionamiento de SetRenderTargets (lo que normalmente no debería ocurrir), el controlador puede devolver D3DDDIERR_DEVICEREMOVED.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3d10umddi.h (incluya D3d10umddi.h) |