Freigeben über


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

Weitere Informationen

DXGKARG_UPDATEMONITOREDVALUES