PFND3D11DDI_DRAWINSTANCEDINDIRECT función de devolución de llamada (d3d10umddi.h)
La función DrawInstancedIndirect dibuja instancias concretas de primitivos no indexados.
Sintaxis
PFND3D11DDI_DRAWINSTANCEDINDIRECT Pfnd3d11ddiDrawinstancedindirect;
void Pfnd3d11ddiDrawinstancedindirect(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HRESOURCE unnamedParam2,
UINT unnamedParam3
)
{...}
Parámetros
unnamedParam1
hDevice [in]
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
hBufferForArgs [in]
Identificador de un búfer que contiene los argumentos para que DrawInstancedIndirect se procese. El búfer contiene la siguiente estructura estrechamente empaquetada:
struct DrawInstancedIndirectArgs {
UINT VertexCountPerInstance;
UINT InstanceCount;
UINT StartVertexLocation;
UINT StartInstanceLocation;
}
Para obtener más información sobre estos argumentos, vea la página de referencia DrawInstanced .
unnamedParam3
AlignedByteOffsetForArgs [in]
Desplazamiento, en bytes, en el búfer que hBufferForArgs especifica. AlignedByteOffsetForArgs debe ser un múltiplo de cuatro.
Valor devuelto
None
Observaciones
El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.
La función DrawInstancedIndirect realiza la misma tarea que la llamada a la función DrawInstanced del controlador. Sin embargo, DrawInstancedIndirect obtiene información sobre los primitivos no indexados del contenido del búfer que especifica el parámetro hBufferForArgs . DrawInstancedIndirect lee el contenido del búfer, empezando por el desplazamiento de bytes que especifica el parámetro AlignedByteOffsetForArgs .
Cuando el tiempo de ejecución de Direct3D llama a la función CreateResource(D3D11) del controlador para crear el recurso de búfer que especifica el parámetro hBufferForArgs , el runtime debe establecer la marca D3D11_DDI_RESOURCE_MISC_DRAWINDIRECT_ARGS en el miembro MiscFlags de la estructura D3D11DDIARG_CREATERESOURCE .
El controlador no debe encontrar ningún error, excepto por D3DDDIERR_DEVICEREMOVED. Por lo tanto, si el controlador pasa algún error, excepto por D3DDDIERR_DEVICEREMOVED, en una llamada a la función pfnSetErrorCb , el tiempo de ejecución de Direct3D determina que el error es crítico. Incluso si se quita el dispositivo, no es necesario que el controlador devuelva D3DDDIERR_DEVICEREMOVED; Sin embargo, si la eliminación de dispositivos interfiere con el funcionamiento de DrawInstancedIndirect (que normalmente no debería ocurrir), el controlador puede devolver D3DDDIERR_DEVICEREMOVED.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | DrawInstancedIndirect se admite a partir del sistema operativo Windows 7. |
| Plataforma de destino | Escritorio |
| Encabezado | d3d10umddi.h (incluya D3d10umddi.h) |