PFND3D10DDI_SETSCISSORRECTS función de devolución de llamada (d3d10umddi.h)
El SetScissorRects función marca partes de destinos de representación a los que se limita la representación.
Sintaxis
PFND3D10DDI_SETSCISSORRECTS Pfnd3d10ddiSetscissorrects;
void Pfnd3d10ddiSetscissorrects(
D3D10DDI_HDEVICE unnamedParam1,
[in] UINT NumRects,
[in] UINT ClearRects,
const D3D10_DDI_RECT *unnamedParam4
)
{...}
Parámetros
unnamedParam1
hDevice [in]
Identificador del dispositivo de visualización (contexto de gráficos).
[in] NumRects
Número total de partes de destino de representación que especifica el parámetro pRects.
[in] ClearRects
Número de partes de destino de representación después del número de partes de destino de representación que NumScisorRects especifica que se va a establecer en NULL. Este número representa la diferencia entre el número anterior de partes de destino de representación (es decir, cuando el tiempo de ejecución de Microsoft Direct3D anteriormente llamó a SetScisorRects) y el nuevo número de partes de destino de representación.
Tenga en cuenta que el número que ClearScisorRects especifica solo es una ayuda de optimización porque el controlador de pantalla en modo de usuario podría calcular este número.
unnamedParam4
pRects [in]
Matriz de estructuras RECT para las partes de destino de representación que se van a marcar.
Valor devuelto
Ninguno
Observaciones
El controlador puede usar el pfnSetErrorCb función de devolución de llamada para establecer un código de error.
La estructura D3D10_DDI_RECT se define como una estructura RECT.
typedef RECT D3D10_DDI_RECT;
El controlador de visualización en modo de usuario debe establecer todas las partes de destino de representación de forma atómica como una operación.
Aunque el parámetro NumScissorRects especifica el número de partes de destino de representación de la matriz que especifica el parámetro pRects, algunos valores de la matriz pueden ser NULL.
Intervalo de partes de destino de representación entre el número que NumScissorRects especifica y se requiere el número máximo de partes de destino de representación permitidas para contener todos los valores NULL o sin enlazar. El número que especifica el parámetro ClearScissorRects informa al controlador sobre cuántas partes de destino de representación debe borrar el controlador para la operación atómica actual.
Si la llamada anterior a setScisorRects pasó un valor de 2 en el parámetro NumScissorRects y la llamada actual a SetScissorRects pasa un valor de 4 en NumScisorRects, la llamada actual a SetScissorRects también pasa un valor de 0 en el parámetro ClearScissorRects . Si la siguiente llamada sucesiva a SetScissorRects pasa un valor de 1 en NumScissorRects, la llamada sucesiva también pasa un valor de 3 (4 - 1) en ClearScissorRects.
Cuando se solicita el valor de partes clear render-target durante las operaciones de consulta en modo de usuario, el valor es la diferencia entre el número máximo de partes de destino de representación y el valor de las partes de destino de representación.
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 SetScissorRects (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) |