PFND3D11DDI_SETRENDERTARGETS función de devolución de llamada (d3d10umddi.h)
La función SetRenderTargets(D3D11) establece superficies de destino de representación.
Sintaxis
PFND3D11DDI_SETRENDERTARGETS Pfnd3d11ddiSetrendertargets;
void Pfnd3d11ddiSetrendertargets(
[in] D3D10DDI_HDEVICE unnamedParam1,
[in] const D3D10DDI_HRENDERTARGETVIEW *unnamedParam2,
[in] UINT NumRTVs,
[in] UINT ClearSlots,
[in] D3D10DDI_HDEPTHSTENCILVIEW unnamedParam5,
[in] const D3D11DDI_HUNORDEREDACCESSVIEW *unnamedParam6,
[in] const UINT *unnamedParam7,
UINT UAVStartSlot,
[in] UINT NumUAVs,
[in] UINT UAVRangeStart,
[in] UINT UAVRangeSize
)
{...}
Parámetros
[in] unnamedParam1
hDevice: identificador del dispositivo de visualización (contexto de gráficos).
[in] unnamedParam2
phRenderTargetView: matriz de identificadores para los objetos de vista de destino de representación (RTV) que se van a establecer. Tenga en cuenta que algunos valores de identificador pueden ser NULL.
[in] NumRTVs
Número de elementos de la matriz proporcionada en phRenderTargetView para los RTV que se van a establecer.
[in] ClearSlots
Número de objetos RTV que se van a desenlacer; es decir, los objetos de vista de destino de representación que estaban enlazados anteriormente, pero que ya no tienen que enlazarse.
[in] unnamedParam5
hDepthStencilView: identificador del búfer de galería de símbolos de profundidad que se va a establecer.
[in] unnamedParam6
phUnorderedAccessView: matriz de identificadores para los objetos de vista de acceso no ordenados (UAV) que se van a establecer.
[in] unnamedParam7
pUAVInitialCounts: matriz de desplazamientos de búfer de anexión y consumo. Este parámetro solo es relevante para las UAV de la matriz phUnorderedAccessView que se crearon con D3D11_DDI_BUFFER_UAV_FLAG_APPEND o D3D11_DDI_BUFFER_UAV_FLAG_COUNTER establecidas en el miembro Flags de la estructura D3D11DDIARG_BUFFER_UNORDEREDACCESSVIEW cuando se creó el UAV; de lo contrario, se omite. Si un elemento de esta matriz se establece en -1, se debe mantener el desplazamiento actual de ese búfer de anexión y consumo. Cualquier otro valor hace que el controlador establezca el contador oculto para ese UAV anexar y consumir búfer.
UAVStartSlot
Índice del primer UAV que se va a enlazar. UAVStartSlot debe ser al menos tan grande como el parámetro NumRTVs .
Nota
Solo existe un conjunto compartido de puntos de enlace para RTV y UAV. Los RTV se enlazan primero, seguidos de UAV.
[in] NumUAVs
Número de UAV que se van a enlazar.
[in] UAVRangeStart
El primer UAV del conjunto de todos los UAV actualizados (que incluye enlaces NULL ).
[in] UAVRangeSize
Número de UAV en el conjunto de todos los UAV actualizados (que incluye enlaces NULL ).
Valor devuelto
None
Observaciones
Los descriptores de recursos como RTV y UAV deben enlazarse (colocar en ranuras de entrada) antes de que los sombreadores puedan acceder a ellos para lectura o escritura.
En la imagen siguiente se muestra un ejemplo con cinco recursos.
En el ejemplo anterior:
- NumRTVs = 2
- UAVStartSlot = 2
- NumUAVs = 3
NumUAVs y UAVStartSlot especifican qué intervalo de la matriz uaVs contiene cambios en relación con el estado que se ha enlazado anteriormente. Tenga en cuenta que los puntos del intervalo podrían no modificarse.
Los parámetros UAVRangeStart yUAVRangeSize son una comodidad que revelan el intervalo de lo que realmente ha cambiado dado que el DDI de Direct3D siempre enlaza todo (incluido lo que no ha cambiado). El tiempo de ejecución D3D11 los formula en nombre de la aplicación como información adicional para los escritores de controladores como sugerencias para la posible optimización. Normalmente, el tiempo de ejecución D3D11 llamará a esta función con valores UAVRangeStart y UAVRangeSize para indicar todo el intervalo. Según el ejemplo anterior:
- Para elegir todo el rango (no se cree que se produzca ningún cambio), UAVRangeStart = 2 y UAVRangeSize = 3.
- Para indicar que solo el primer UAV podría haber cambiado, UAVRangeStart = 2 y UAVRangeSize = 1.
El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.
El controlador no debe encontrar ningún error, excepto por D3DDDIERR_DEVICEREMOVED. Por lo tanto, si el controlador pasa algún error, excepto por D3DDDIERR_DEVICEREMOVED, en una llamada a la función pfnSetErrorCb , 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 del dispositivo interfirió con el funcionamiento de SetRenderTargets (que normalmente no debería ocurrir), el controlador puede devolver D3DDDIERR_DEVICEREMOVED.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | SetRenderTargets(D3D11) se admite a partir del sistema operativo Windows 7. |
| Plataforma de destino | Escritorio |
| Encabezado | d3d10umddi.h (incluya D3d10umddi.h) |