Partilhar via


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 de 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 de CalcPrivateRasterizerStateSize do 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 seu objeto de estado de rasterizador.

unnamedParam4

hRTRasterizerState [in]

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

Valor de retorno

Nenhum

Observações

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 algum erro, 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 no 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

Requisito Valor
de cliente com suporte mínimo Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino Área de trabalho
cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

CalcPrivateRasterizerStateSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_RASTERIZER_DESC

DestroyRasterizerState

pfnSetErrorCb