DXGKDDI_UPDATEMONITOREDVALUES Rückruffunktion (d3dkmddi.h)
Dxgkrnl ruft DxgkDdiUpdateMonitoredValues auf, um den Kernelmodusanzeigetreiber (KMD) anzuweisen, einen Batch überwachter Werte zu aktualisieren.
Syntax
DXGKDDI_UPDATEMONITOREDVALUES DxgkddiUpdatemonitoredvalues;
NTSTATUS DxgkddiUpdatemonitoredvalues(
IN_CONST_PDXGKARG_UPDATEMONITOREDVALUES pUpdateMonitoredValues
)
{...}
Parameter
pUpdateMonitoredValues
[in] Zeiger auf eine DXGKARG_UPDATEMONITOREDVALUES-Struktur , die die zu aktualisierenden überwachten Werte enthält.
Rückgabewert
DxgkDdiUpdateMonitoredValues gibt STATUS_SUCCESS zurück, wenn KMD den Batch der überwachten Werte erfolgreich aktualisieren konnte. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.
Hinweise
DxgkDdiUpdateMonitoredValues wird auf geräteunterbrechender Ebene ausgeführt und somit mit der überwachten Fence Signaled Interrupt Service Routine (ISR) synchronisiert.
Die DxgkDdiUpdateMonitoredValues-Implementierung eines KMD muss sicherstellen, dass der CurrentValue-Wert , der von jedem Prozessorkern gelesen wurde, nachdem der Aufruf zurückgegeben wurde, vom GPU-Kontextverwaltungsprozessor geschrieben wurde, nachdem er den neuen MonitoredValue beobachtet hat.
DxgkDdiUpdateMonitoredValues wird erwartet, dass die UpdatedValueArray-Werte an den von MonitoredValueGpuVa angegebenen Speicherort geschrieben werden, während der Synchronisierungsvertrag berücksichtigt wird.
Das Betriebssystem garantiert nur, dass der MonitoredValueKernelCpuVa-Zeiger für die Dauer dieses DDI-Aufrufs gültig ist und nicht davor oder danach. Daher darf KMD diesen Zeiger niemals zwischenspeichern, um ihn an anderer Stelle zu verwenden.
Weitere Informationen zu nativen GPU-Zäunen finden Sie unter Native GPU-Fence-Objekte.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 11, Version 24H2 |
Kopfzeile | d3dkmddi.h |
IRQL | PROFILE_LEVEL-1 |