Compartilhar 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 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 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 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 erros, 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 parâmetro hSampler .

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 amostra em um dispositivo por vez.

Requisitos

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

Confira também

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb