Método ID3D11DeviceContext::D ispatch (d3d11.h)

Ejecute una lista de comandos desde un grupo de subprocesos.

Sintaxis

void Dispatch(
  [in] UINT ThreadGroupCountX,
  [in] UINT ThreadGroupCountY,
  [in] UINT ThreadGroupCountZ
);

Parámetros

[in] ThreadGroupCountX

Tipo: UINT

Número de grupos enviados en la dirección x. ThreadGroupCountX debe ser menor o igual que D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535).

[in] ThreadGroupCountY

Tipo: UINT

Número de grupos enviados en la dirección y. ThreadGroupCountY debe ser menor o igual que D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535).

[in] ThreadGroupCountZ

Tipo: UINT

Número de grupos enviados en la dirección z. ThreadGroupCountZ debe ser menor o igual que D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). En el nivel de característica 10, el valor de ThreadGroupCountZ debe ser 1.

Valor devuelto

None

Observaciones

Se llama al método Dispatch para ejecutar comandos en un sombreador de proceso. Un sombreador de proceso se puede ejecutar en muchos subprocesos en paralelo, dentro de un grupo de subprocesos. Indexe un subproceso determinado, dentro de un grupo de subprocesos mediante un vector 3D proporcionado por (x,y,z).

En la ilustración siguiente, supongamos un grupo de subprocesos con 50 subprocesos en los que el tamaño del grupo recibe (5,5,2). Un único subproceso se identifica desde un grupo de subprocesos con 50 subprocesos en él, utilizando el vector (4,1,1).

Ilustración de un único subproceso dentro de un grupo de subprocesos de 50 subprocesos

En la ilustración siguiente se muestra la relación entre los parámetros pasados a ID3D11DeviceContext::D ispatch, Dispatch(5,3,2), los valores especificados en el atributo numthreads, numthreads(10,8,3) y los valores que se pasarán al sombreador de proceso para los valores del sistema relacionados con el subproceso (SV_GroupIndex,SV_DispatchThreadID,SV_GroupThreadID,SV_GroupID).

Ilustración de la relación entre Dispatch, grupos de subprocesos y subprocesos

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d11.h
Library D3D11.lib

Consulte también

ID3D11DeviceContext