DXGKDDI_SUBMITCOMMAND función de devolución de llamada (d3dkmddi.h)
La función DxgkDdiSubmitCommand envía un búfer de acceso directo a memoria (DMA) a la unidad de ejecución de comandos de hardware.
Sintaxis
DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;
NTSTATUS DxgkddiSubmitcommand(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}
Parámetros
[in] hAdapter
Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .
[in] pSubmitCommand
Puntero a una estructura de DXGKARG_SUBMITCOMMAND que describe el búfer DMA que el controlador de miniporte de pantalla envía a la unidad de ejecución de comandos de hardware.
Valor devuelto
DxgkDdiSubmitCommand devuelve STATUS_SUCCESS tras la finalización correcta. Si el controlador devuelve en su lugar un código de error, el sistema operativo hace que se produzca una comprobación de errores del sistema. Vea la sección Comentarios.
Comentarios
Dado que las operaciones de paginación se consideran operaciones del sistema, no están asociadas a un contexto de aplicación específico o contexto de gráficos. Por lo tanto, cuando el envío es para una operación de paginación, se llama a la función DxgkDdiSubmitCommand con NULL especificado en el miembro hDevice de la estructura DXGKARG_SUBMITCOMMAND a la que apunta el parámetro pSubmitCommand .
Sin embargo, si la arquitectura de un determinado hardware y controlador debe tener un dispositivo internamente, el controlador debe crear internamente el dispositivo durante la inicialización del adaptador y debe mantener el dispositivo internamente como el dispositivo predeterminado del sistema para su uso en las operaciones de paginación.
El controlador puede escribir el valor proporcionado en el miembro SubmissionFenceId de DXGKARG_SUBMITCOMMAND en el comando de barrera en el búfer de anillo. Para obtener más información sobre los comandos de barrera, consulte Suministro de identificadores de barrera.
Si el controlador devuelve un código de error, el subsistema del kernel de gráficos de DirectX hace que se produzca una comprobación de errores del sistema. En un archivo de volcado de memoria, el mensaje BugCheck 0x119 indica el error, que tendrá los cuatro parámetros siguientes.
- 0x2 (identifica la causa del error)
- El código de error NTSTATUS devuelto por la llamada de controlador con error
- Puntero a la estructura de DXGKARG_SUBMITCOMMAND
- Puntero a una estructura de datos de programador interna
DxgkDdiSubmitCommand debe ser no paginable porque se ejecuta en IRQL = DISPATCH_LEVEL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |