PFND3D10DDI_CREATESAMPLER funzione di callback (d3d10umddi.h)

La funzione CreateSampler crea un campionatore.

Sintassi

PFND3D10DDI_CREATESAMPLER Pfnd3d10ddiCreatesampler;

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

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pSamplerDesc [in]

Puntatore a una struttura D3D10_DDI_SAMPLER_DESC che descrive i parametri usati dal driver di visualizzazione in modalità utente per creare un campionatore.

unnamedParam3

hSampler [in]

Handle per i dati privati del driver per il campionatore. Il driver restituisce le dimensioni, in byte, dell'area di memoria che il runtime di Microsoft Direct3D deve allocare per i dati privati da una chiamata alla funzione CalcPrivateSamplerSize del driver. L'handle è in realtà solo un puntatore a un'area di memoria, le cui dimensioni sono richieste dal driver. Il driver usa questa area di memoria per archiviare strutture di dati interne correlate all'oggetto sampler.

unnamedParam4

hRTSampler [in]

Handle per l'sampler che il driver deve usare ogni volta che viene chiamato nel runtime Direct3D.

Valore restituito

nessuno

Osservazioni

Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore.

Il driver può passare E_OUTOFMEMORY (se il driver esaurisce la memoria) o D3DDDIERR_DEVICEREMOVED (se il dispositivo è stato rimosso) in una chiamata alla funzione pfnSetErrorCb . Il runtime Direct3D determinerà che tutti gli altri errori sono critici. Se il driver passa errori, incluso D3DDDIERR_DEVICEREMOVED, il runtime Direct3D determinerà che l'handle non è valido; pertanto, il runtime non chiamerà la funzione DestroySampler per eliminare definitivamente l'handle specificato dal parametro hSampler .

Il driver di visualizzazione in modalità utente non è necessario per creare più di 4.096 istanze univoce di oggetti sampler in un dispositivo alla volta.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione d3d10umddi.h (include D3d10umddi.h)

Vedi anche

CalcPrivateSamplerSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_SAMPLER_DESC

DestroySampler

pfnSetErrorCb