DXGKCB_SYNCHRONIZE_EXECUTION función de devolución de llamada (dispmprt.h)

  • Artículo

La función DxgkCbSynchronizeExecution sincroniza una función especificada, implementada por el controlador de miniporte de pantalla, con la función DxgkDdiInterruptRoutine del controlador de miniporte de pantalla.

Sintaxis

DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;

NTSTATUS DxgkcbSynchronizeExecution(
  [in]  HANDLE DeviceHandle,
  [in]  PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
  [in]  PVOID Context,
  [in]  ULONG MessageNumber,
  [out] PBOOLEAN ReturnValue
)
{...}

Parámetros

[in] DeviceHandle

Identificador que representa un adaptador de pantalla. El controlador de minipuerto de pantalla obtuvo previamente este identificador en el miembro DeviceHandle de la estructura DXGKRNL_INTERFACE que se pasó a DxgkDdiStartDevice.

[in] SynchronizeRoutine

Puntero a una función, implementada por el controlador de miniporte de pantalla, que se sincronizará con DxgkDdiInterruptRoutine. La función debe cumplir el siguiente prototipo:

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

Puntero a un bloque de contexto, creado por el controlador de minipuerto de pantalla, que se pasará a SynchronizeRoutine.

[in] MessageNumber

Número del mensaje de interrupción con el que se sincronizará SynchronizeRoutine . Si la interrupción está basada en líneas, este parámetro debe ser cero.

[out] ReturnValue

Puntero a una variable booleana que recibe el valor devuelto de SynchronizeRoutine.

Valor devuelto

DxgkCbSynchronizeExecution devuelve uno de los siguientes valores:

Código devuelto Descripción
STATUS_SUCCESS La función se ha realizado correctamente.
STATUS_INVALID_PARAMETER Uno de los parámetros no es válido.
STATUS_UNSUCCESSFUL La función no pudo sincronizar la ejecución, posiblemente porque la interrupción aún no se había conectado.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado dispmprt.h (include Dispmprt.h)
IRQL <=DISPATCH_LEVEL

Consulte también

DxgkDdiInterruptRoutine

KeSynchronizeExecution