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) |