Share via

PFND3D10DDI_SO_SETTARGETS función de devolución de llamada (d3d10umddi.h)

  • Artículo

La función SoSetTargets establece los recursos de destino de salida del 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

El número de identificadores para transmitir los recursos de destino de salida que representa 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 especificaClearTargets 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

None

Observaciones

El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.

El 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 es necesario que contenga 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 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 de dispositivos interfirió con el funcionamiento de SOTargets (que normalmente no debería ocurrir), el controlador puede devolver D3DDDIERR_DEVICEREMOVED.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado d3d10umddi.h (incluya D3d10umddi.h)

Consulte también

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb