PFND3D11DDI_DRAWINSTANCEDINDIRECT funzione di callback (d3d10umddi.h)
La funzione DrawInstancedIndirect disegna istanze particolari di primitive non indicizzate.
Sintassi
PFND3D11DDI_DRAWINSTANCEDINDIRECT Pfnd3d11ddiDrawinstancedindirect;
void Pfnd3d11ddiDrawinstancedindirect(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HRESOURCE unnamedParam2,
UINT unnamedParam3
)
{...}
Parametri
unnamedParam1
hDevice [in]
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
hBufferForArgs [in]
Handle a un buffer che contiene gli argomenti per DrawInstancedIndirect da elaborare. Il buffer contiene la struttura strettamente confezionata seguente:
struct DrawInstancedIndirectArgs {
UINT VertexCountPerInstance;
UINT InstanceCount;
UINT StartVertexLocation;
UINT StartInstanceLocation;
}
Per altre informazioni su questi argomenti, vedere la pagina di riferimento DrawInstanced .
unnamedParam3
AlignedByteOffsetForArgs [in]
Offset, in byte, nel buffer specificato da hBufferForArgs . AlignedByteOffsetForArgs deve essere un multiplo di quattro.
Valore restituito
nessuno
Osservazioni
Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore.
La funzione DrawInstancedIndirect esegue la stessa attività della chiamata alla funzione DrawInstanced del driver. Tuttavia, DrawInstancedIndirect ottiene informazioni sulle primitive non indicizzate dal contenuto del buffer specificato dal parametro hBufferForArgs. DrawInstancedIndirect legge il contenuto del buffer, a partire dall'offset di byte specificato dal parametro AlignedByteOffsetForArgs .
Quando il runtime Direct3D chiama la funzione CreateResource(D3D11) del driver per creare la risorsa buffer specificata dal parametro hBufferForArgs , il runtime deve impostare il flag di D3D11_DDI_RESOURCE_MISC_DRAWINDIRECT_ARGS nel membro MiscFlagsdella struttura D3D11DDIARG_CREATERESOURCE.
Il driver non deve riscontrare alcun errore, ad eccezione di D3DDDIERR_DEVICEREMOVED. Pertanto, se il driver passa qualsiasi errore, ad eccezione di D3DDDIERR_DEVICEREMOVED, in una chiamata alla funzione pfnSetErrorCb , il runtime Direct3D determina che l'errore è critico. Anche se il dispositivo viene rimosso, il driver non è necessario restituire D3DDDIERR_DEVICEREMOVED; tuttavia, se la rimozione del dispositivo interferisce con l'operazione di DrawInstancedIndirect (che in genere non dovrebbe verificarsi), il driver può restituire D3DDDIERR_DEVICEREMOVED.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | DrawInstancedIndirect è supportato a partire dal sistema operativo Windows 7. |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3d10umddi.h (include D3d10umddi.h) |