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)

Consulte también

D3D11DDIARG_BUFFER_UNORDEREDACCESSVIEW

D3D11DDI_DEVICEFUNCS

pfnSetErrorCb