PFND3D10DDI_CREATERASTERIZERSTATE função de retorno de chamada (d3d10umddi.h)

A função CreateRasterizerState cria um estado de rasterizador.

Sintaxe

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]

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pRasterizerDesc [in]

Um ponteiro para uma estrutura D3D10_DDI_RASTERIZER_DESC que descreve os parâmetros que o driver de exibição do modo de usuário usa para criar um estado de rasterizador.

unnamedParam3

hRasterizerState [in]

Um identificador para os dados privados do driver para o estado do rasterizador. O driver retorna o tamanho, em bytes, da região de memória que o runtime do Microsoft Direct3D deve alocar para os dados privados de uma chamada para a função CalcPrivateRasterizerStateSize do driver. O identificador é, na verdade, apenas um ponteiro para uma região de memória, o tamanho do qual o driver solicitou. O driver usa essa região de memória para armazenar estruturas de dados internas relacionadas ao objeto de estado do rasterizador.

unnamedParam4

hRTRasterizerState [in]

Um identificador para o estado do rasterizador que o driver deve usar sempre que chamar de volta para o runtime do Direct3D.

Retornar valor

Nenhum

Comentários

O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro.

O driver pode passar E_OUTOFMEMORY (se o driver ficar sem memória) ou D3DDDIERR_DEVICEREMOVED (se o dispositivo tiver sido removido) em uma chamada para a função pfnSetErrorCb . O runtime do Direct3D determinará que quaisquer outros erros são críticos. Se o driver passar por erros, incluindo D3DDDIERR_DEVICEREMOVED, o runtime do Direct3D determinará que o identificador é inválido; portanto, o runtime não chamará a função DestroyRasterizerState para destruir o identificador especificado pelo parâmetro hRasterizerState .

O driver de exibição do modo de usuário não é necessário para criar mais de 4.096 instâncias exclusivas de objetos de estado de rasterizador em um dispositivo por vez.

Requisitos

Confira também

CalcPrivateRasterizerStateSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_RASTERIZER_DESC

DestroyRasterizerState

pfnSetErrorCb