Función D3DKMTSubmitCommand (d3dkmthk.h)

D3DKMTSubmitCommand se usa para enviar búferes de comandos en contextos que admiten el direccionamiento virtual de la unidad de procesamiento gráfico (GPU). Estos contextos generan comandos directamente desde el modo de usuario, administran su propio grupo de búferes de comandos y no usan la lista de ubicaciones de asignación o revisión.

Sintaxis

NTSTATUS D3DKMTSubmitCommand(
  [in] const D3DKMT_SUBMITCOMMAND *unnamedParam1
);

Parámetros

[in] unnamedParam1

Puntero a una estructura D3DKMT_SUBMITCOMMAND que describe la operación.

Valor devuelto

Código devuelto	Descripción
STATUS_SUCCESS	El contexto del dispositivo se creó correctamente.
STATUS_INVALID_PARAMETER	Los parámetros se validaron y determinaron que son incorrectos.

Esta función también podría devolver otros valores NTSTATUS .

Comentarios

Esta función reemplaza la antigua función Render para estos contextos y se debe usar en su lugar. Los contextos que funcionan en el modo de revisión heredado deben seguir usando la función Render anterior.

Aunque el controlador en modo de usuario no genera ubicaciones de revisión, todavía debe generar una lista de elementos principales en los que se escribe. El administrador de memoria de vídeo usa la lista de asignación para determinar a qué asignaciones principales se hace referencia para la escritura por cada búfer de comandos. Esta información se usa para sincronizar la representación con las principales con operaciones de volteo .

Algunos controladores de modo kernel necesitan información de su controlador de modo de usuario sobre cómo enviar un búfer de acceso directo a memoria (DMA) determinado a su GPU. En windows Display Driver Model (WDDM) 1.0, el controlador de modo de usuario envió esta información al controlador de modo kernel a través del búfer de comandos. Dado que el controlador del modo de usuario compila directamente el búfer DMA y se envía a la GPU sin modificaciones, ya no se puede usar para enviar información al controlador del kernel. Para habilitar la transferencia de información entre el modo de usuario y los controladores de modo kernel, se ha agregado un búfer de datos de controlador privado explícito para enviarse junto con un envío.

Nota

Estos datos del controlador privado son unidireccionales y el controlador en modo kernel no puede devolver información al controlador en modo de usuario a través de este búfer.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10
Servidor mínimo compatible	Windows Server 2016
Plataforma de destino	Universal
Encabezado	d3dkmthk.h (incluya D3dkmthk.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll

Consulte también

D3DKMT_SUBMITCOMMAND