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

Artículo
02/22/2024

La función CreateRasterizerState crea un estado de rasterizador.

Sintaxis

PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;

void Pfnd3d10ddiCreaterasterizerstate(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_RASTERIZER_DESC *unnamedParam2,
  D3D10DDI_HRASTERIZERSTATE unnamedParam3,
  D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}

Parámetros

unnamedParam1

hDevice [in]

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

pRasterizerDesc [in]

Puntero a una estructura de D3D10_DDI_RASTERIZER_DESC que describe los parámetros que usa el controlador de visualización en modo de usuario para crear un estado de rasterizador.

unnamedParam3

hRasterizerState [in]

Identificador de los datos privados del controlador para el estado de rasterizador. El controlador devuelve el tamaño, en bytes, de la región de memoria que el tiempo de ejecución de Microsoft Direct3D debe asignar para los datos privados desde una llamada a la función CalcPrivateRasterizerStateSize del controlador. El identificador es realmente un puntero a una región de memoria, el tamaño del que solicitó el controlador. El controlador usa esta región de memoria para almacenar estructuras de datos internas relacionadas con su objeto de estado de rasterizador.

unnamedParam4

hRTRasterizerState [in]

Identificador del estado de rasterizador que el controlador debe usar cada vez que llame al entorno de ejecución de Direct3D.

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 controlador puede pasar E_OUTOFMEMORY (si el controlador se queda sin memoria) o D3DDDIERR_DEVICEREMOVED (si se ha quitado el dispositivo) en una llamada a la función pfnSetErrorCb . El tiempo de ejecución de Direct3D determinará que cualquier otro error es crítico. Si el controlador pasa algún error, incluido D3DDDIERR_DEVICEREMOVED, el tiempo de ejecución de Direct3D determinará que el identificador no es válido; Por lo tanto, el runtime no llamará a la función DestroyRasterizerState para destruir el identificador que especifica el parámetro hRasterizerState .

El controlador de pantalla en modo de usuario no es necesario para crear más de 4096 instancias únicas de objetos de estado de rasterizador en un dispositivo a la vez.

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)