DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES función de devolución de llamada (d3dkmddi.h)

Configure o modifique las propiedades de programación para un contexto de dispositivo.

Sintaxis

DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES DxgkddiSetcontextschedulingproperties;

NTSTATUS DxgkddiSetcontextschedulingproperties(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SETCONTEXTSCHEDULINGPROPERTIES pSetContextSchedulingProperties
)
{...}

Parámetros

hAdapter

Identificador del contexto del dispositivo.

pSetContextSchedulingProperties

Puntero a una estructura de DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES que contiene las propiedades de programación.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS Values adecuado.

Observaciones

Registre la implementación de esta función de devolución de llamada estableciendo el miembro adecuado de DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES y, a continuación, llamando a DxgkDdiSetContextSchedulingProperties.

Cuando se abre un adaptador por primera vez para un proceso determinado, el sistema operativo llama a DxgkDdiCreateProcess para que el controlador del modo kernel (KMD) pueda crear un adecuado por proceso, por estructura de datos de seguimiento del adaptador. Cuando se crea un contexto, el KMD sabe para qué dispositivo y adaptador se crea y debe poder buscar el identificador de proceso de KMD desde la estructura de datos de seguimiento del adaptador para este proceso. Dentro del proceso de KMD, se espera que el programador tenga estructuras de datos de seguimiento para los cuatro posibles contextos de bandas de prioridad a los que se deben asignar.

Cuando se crea un contexto, o un dispositivo Direct3D cambia la prioridad, o una aplicación obtiene o pierde el foco, el sistema operativo llama al programador de GPU para configurar o modificar sus propiedades de programación. En el caso de los contextos recién creados, el sistema operativo garantiza que las propiedades de programación de contexto se establecerán antes del primer envío a este contexto. Esta llamada se puede realizar en medio de una ejecución de contexto. El programador de GPU tiene cierto margen en cuanto a cómo afecta al período de programación actual y el requisito del sistema operativo es que el cambio debe surtir efecto en la siguiente iteración de programación para la banda de prioridad.

Requisitos

Requisito	Valor
encabezado de	d3dkmddi.h