Función D3DKMTSubmitCommand (d3dkmthk.h)
D3DKMTSubmitCommand se usa para enviar búferes de comandos en contextos que admiten direccionamiento virtual de unidad de procesamiento de gráficos (GPU). Estos contextos generan comandos directamente desde el modo de usuario, administran su propio grupo de búferes de comandos y no hacen uso de 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 puede devolver otros valores de NTSTATUS.
Observaciones
Esta función reemplaza a la antigua función Render para estos contextos y debe usarse en su lugar. Los contextos que funcionan en el modo de revisión heredado deben seguir usando la antigua función Render.
Aunque el controlador del modo de usuario no genera ubicaciones de revisión, todavía debe generar una lista de elementos principales, en los que se están escribiendo. El administrador de memoria de vídeo usa la lista de asignación para determinar a qué asignaciones principales se hace referencia para escribir por cada búfer de comandos. Esta información se usa para sincronizar la representación con las principales con operaciones de voltear.
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 del modo kernel a través del búfer de comandos. Dado que el controlador del modo de usuario crea 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 del modo kernel no puede devolver información al controlador en modo de usuario a través de este búfer.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Universal |
| encabezado de | d3dkmthk.h (incluya D3dkmthk.h) |
| biblioteca de | Gdi32.lib |
| DLL de | Gdi32.dll |