DXGKCB_SYNCHRONIZE_EXECUTION Rückruffunktion (dispmprt.h)
Die DxgkCbSynchronizeExecution-Funktion synchronisiert eine angegebene Funktion, die vom Anzeigeminiporttreiber 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 Anzeigeminiporttreiber 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 und mit DxgkDdiInterruptRoutine synchronisiert wird. Die Funktion muss dem folgenden Prototyp entsprechen:
BOOLEAN SynchronizeRoutine(PVOID Context);
[in] Context
Ein Zeiger auf einen Kontextblock, der vom Anzeigeminiporttreiber erstellt wird und an SynchronizeRoutine übergeben wird.
[in] MessageNumber
Die Nummer der Interruptmeldung, mit der SynchronizeRoutine synchronisiert wird. Wenn der Interrupt zeilenbasiert ist, muss dieser Parameter 0 sein.
[out] ReturnValue
Ein Zeiger auf eine boolesche Variable, die den Rückgabewert von SynchronizeRoutine empfängt.
Rückgabewert
DxgkCbSynchronizeExecution gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion wurde erfolgreich ausgeführt. |
| 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h (include Dispmprt.h) |
| IRQL | <=DISPATCH_LEVEL |