DXGKCB_SYNCHRONIZE_EXECUTION funzione di callback (dispmprt.h)

  • Articolo

La funzione DxgkCbSynchronizeExecution sincronizza una funzione specificata, implementata dal driver miniport visualizzato, con la funzione DxgkDdiInterruptRoutine del driver di visualizzazione.

Sintassi

DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;

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

Parametri

[in] DeviceHandle

Handle che rappresenta una scheda di visualizzazione. Il driver miniport visualizzato in precedenza ha ottenuto questo handle nel membro DeviceHandle della struttura DXGKRNL_INTERFACE passata a DxgkDdiStartDevice.

[in] SynchronizeRoutine

Puntatore a una funzione, implementata dal driver miniport visualizzato, che verrà sincronizzata con DxgkDdiInterruptRoutine. La funzione deve essere conforme al prototipo seguente:

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

Puntatore a un blocco di contesto creato dal driver miniport visualizzato, che verrà passato a SyncRoutine.

[in] MessageNumber

Numero del messaggio di interruzione con cui SyncRoutine verrà sincronizzato. Se l'interruzione è basata su riga, questo parametro deve essere zero.

[out] ReturnValue

Puntatore a una variabile booleana che riceve il valore restituito di SyncRoutine.

Valore restituito

DxgkCbSynchronizeExecution restituisce uno dei valori seguenti:

Codice restituito Descrizione
STATUS_SUCCESS Funzione completata.
STATUS_INVALID_PARAMETER Uno dei parametri non è valido.
STATUS_UNSUCCESSFUL La funzione non è riuscita a sincronizzare l'esecuzione, probabilmente perché l'interruzione non era ancora stata connessa.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione dispmprt.h (include Dispmprt.h)
IRQL <=DISPATCH_LEVEL

Vedi anche

DxgkDdiInterruptRoutine

KeSynchronizeExecution