PFND3D10DDI_SO_SETTARGETS función de devolución de llamada (d3d10umddi.h)
El SoSetTargets función establece los recursos de destino de salida de flujo.
Sintaxis
PFND3D10DDI_SO_SETTARGETS Pfnd3d10ddiSoSettargets;
void Pfnd3d10ddiSoSettargets(
D3D10DDI_HDEVICE unnamedParam1,
[in] UINT NumBuffers,
[in] UINT ClearTargets,
const D3D10DDI_HRESOURCE *unnamedParam4,
const UINT *unnamedParam5
)
{...}
Parámetros
unnamedParam1
hDevice [in]
Identificador del dispositivo de visualización (contexto de gráficos).
[in] NumBuffers
Número de elementos de la matriz que phResource especifica.
[in] ClearTargets
Número de identificadores para transmitir recursos de destino de salida que representan la diferencia entre el número anterior de recursos de destino de salida de flujo (antes de que el tiempo de ejecución de Microsoft Direct3D llame a SoSetTargets) y el nuevo número de recursos de destino de salida de flujo.
Tenga en cuenta que el número que iClearTargets especifica es solo una ayuda de optimización porque el controlador de pantalla en modo de usuario podría calcular este número.
unnamedParam4
phResource [in]
Matriz de identificadores para los recursos de destino de salida de flujo que se van a establecer. Tenga en cuenta que algunos valores de identificador pueden ser NULL.
unnamedParam5
pOffsets [in]
Matriz de desplazamientos, en bytes, en los recursos de destino de salida de flujo de la matriz que phResource especifica.
Valor devuelto
Ninguno
Observaciones
El controlador puede usar el pfnSetErrorCb función de devolución de llamada para establecer un código de error.
Intervalo de recursos de destino de salida de flujo entre el número que especifica el parámetro SOTargets y el número máximo de recursos de destino de salida de flujo permitidos 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 actual. Si la llamada anterior a SoSetTargets pasó un valor de 2 en SOTargetsy la llamada actual a SoSetTargets pasa un valor de 4 en SOTargets, la llamada actual a SoSetTargets también pasa un valor de 0 en el parámetro ClearTargets. Si la siguiente llamada sucesiva a SoSetTargets pasa un valor de 1 en SOTargets, la llamada sucesiva también pasa un valor de 3 (4 - 1) en ClearTargets.
El controlador no debe encontrar ningún error, excepto D3DDDIERR_DEVICEREMOVED. Por lo tanto, si el controlador pasa cualquier 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 de dispositivos interfirió con el funcionamiento de SOTargets (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) |