PFND3D10DDI_CREATERASTERIZERSTATE funzione di callback (d3d10umddi.h)
La funzione CreateRasterizerState crea uno stato di rasterizzazione.
Sintassi
PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;
void Pfnd3d10ddiCreaterasterizerstate(
D3D10DDI_HDEVICE unnamedParam1,
const D3D10_DDI_RASTERIZER_DESC *unnamedParam2,
D3D10DDI_HRASTERIZERSTATE unnamedParam3,
D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}
Parametri
unnamedParam1
hDevice [in]
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pRasterizerDesc [in]
Puntatore a una struttura D3D10_DDI_RASTERIZER_DESC che descrive i parametri usati dal driver di visualizzazione in modalità utente per creare uno stato di rasterizzazione.
unnamedParam3
hRasterizerState [in]
Handle per i dati privati del driver per lo stato del rasterizzatore. 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 del driver CalcPrivateRasterizerStateSize. L'handle è davvero 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 stato rasterizzatore.
unnamedParam4
hRTRasterizerState [in]
Handle per lo stato del rasterizzatore che il driver deve usare ogni volta che richiama nel runtime Direct3D.
Valore restituito
Nessuno
Osservazioni
Il driver può usare il pfnSetErrorCb funzione di callback 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 eventuali altri errori sono critici. Se il driver supera eventuali errori, incluso D3DDDIERR_DEVICEREMOVED, il runtime Direct3D determinerà che l'handle non è valido; pertanto, il runtime non chiamerà la funzione DestroyRasterizerState per eliminare definitivamente l'handle specificato dal parametro hRasterizerState.
Il driver di visualizzazione in modalità utente non è necessario per creare più di 4.096 istanze univoci di oggetti di stato rasterizzatore in un dispositivo alla volta.
Fabbisogno
| 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) |