Share via

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

  • Artículo

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

Consulte también

DXGKARG_SUBMITCOMMAND

DxgkDdiAddDevice