Partilhar via


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

A função CreateSampler cria um sampler.

Sintaxe

PFND3D10DDI_CREATESAMPLER Pfnd3d10ddiCreatesampler;

void Pfnd3d10ddiCreatesampler(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_SAMPLER_DESC *unnamedParam2,
  D3D10DDI_HSAMPLER unnamedParam3,
  D3D10DDI_HRTSAMPLER unnamedParam4
)
{...}

Parâmetros

unnamedParam1

hDevice [in]

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

unnamedParam2

pSamplerDesc [in]

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

unnamedParam3

hSampler [in]

Um identificador para os dados privados do driver para o sampler. 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 CalcPrivateSamplerSize 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 sampler.

unnamedParam4

hRTSampler [in]

Um identificador para o sampler 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 DestroySampler para destruir o identificador especificado pelo hSampler parâmetro.

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 sampler em um dispositivo de cada 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

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb