PFND3D11DDI_DRAWINSTANCEDINDIRECT función de devolución de llamada (d3d10umddi.h)

Artículo
02/22/2024

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)