DXGKCB_SYNCHRONIZE_EXECUTION funzione di callback (dispmprt.h)
La funzione DxgkCbSynchronizeExecution sincronizza una funzione specificata, implementata dal driver miniport di visualizzazione, con il driver miniport visualizzato DxgkDdiInterruptRoutine funzione.
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 di visualizzazione precedentemente ottenuto questo handle nel membro DeviceHandle del DXGKRNL_INTERFACE passato a DxgkDdiStartDevice.
[in] SynchronizeRoutine
Puntatore a una funzione, implementata dal driver miniport di visualizzazione, 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 di visualizzazione, che verrà passato a SynchronizeRoutine.
[in] MessageNumber
Numero del messaggio di interrupt con cui verrà sincronizzato SynchronizeRoutine. Se l'interrupt è basato su riga, questo parametro deve essere zero.
[out] ReturnValue
Puntatore a una variabile booleana che riceve il valore restituito di SynchronizeRoutine.
Valore restituito
DxgkCbSynchronizeExecution restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | La funzione ha avuto esito positivo. |
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. |
| STATUS_UNSUCCESSFUL | La funzione non è stata in grado di sincronizzare l'esecuzione, probabilmente perché l'interrupt non era ancora stato connesso. |
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | dispmprt.h (include Dispmprt.h) |
| IRQL | <=DISPATCH_LEVEL |