DXGKCB_SYNCHRONIZE_EXECUTION Rückruffunktion (dispmprt.h)
Die DxgkCbSynchronizeExecution--Funktion synchronisiert eine angegebene Funktion, die vom Display miniport-Treiber implementiert wird, mit der DxgkDdiInterruptRoutine-Funktion des Anzeigeminiporttreibers.
Syntax
DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;
NTSTATUS DxgkcbSynchronizeExecution(
[in] HANDLE DeviceHandle,
[in] PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
[in] PVOID Context,
[in] ULONG MessageNumber,
[out] PBOOLEAN ReturnValue
)
{...}
Parameter
[in] DeviceHandle
Ein Handle, das einen Anzeigeadapter darstellt. Der Display-Miniporttreiber hat dieses Handle zuvor im DeviceHandle Member der DXGKRNL_INTERFACE Struktur abgerufen, die an DxgkDdiStartDeviceübergeben wurde.
[in] SynchronizeRoutine
Ein Zeiger auf eine Funktion, die vom Anzeigeminiporttreiber implementiert wird, der mit DxgkDdiInterruptRoutinesynchronisiert wird. Die Funktion muss dem folgenden Prototyp entsprechen:
BOOLEAN SynchronizeRoutine(PVOID Context);
[in] Context
Ein Zeiger auf einen Kontextblock, der vom Anzeigeminiporttreiber erstellt wird, der an SynchronizeRoutineübergeben wird.
[in] MessageNumber
Die Nummer der Unterbrechungsnachricht, mit der SynchronizeRoutine- synchronisiert werden. Wenn der Interrupt zeilenbasiert ist, muss dieser Parameter null sein.
[out] ReturnValue
Ein Zeiger auf eine boolesche Variable, die den Rückgabewert SynchronizeRoutineempfängt.
Rückgabewert
DxgkCbSynchronizeExecution gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_INVALID_PARAMETER | Einer der Parameter ist ungültig. |
| STATUS_UNSUCCESSFUL | Die Funktion konnte die Ausführung nicht synchronisieren, möglicherweise weil der Interrupt noch nicht verbunden war. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | dispmprt.h (include Dispmprt.h) |
| IRQL- | <=DISPATCH_LEVEL |