Freigeben über


DXGKDDI_UPDATEMONITOREDVALUES Rückruffunktion (d3dkmddi.h)

Dxgkrnl- aufruft DxgkDdiUpdateMonitoredValues, den Kernelmodusanzeigetreiber (KMD) anzuweisen, einen Batch überwachter Werte zu aktualisieren.

Syntax

DXGKDDI_UPDATEMONITOREDVALUES DxgkddiUpdatemonitoredvalues;

NTSTATUS DxgkddiUpdatemonitoredvalues(
  IN_CONST_PDXGKARG_UPDATEMONITOREDVALUES pUpdateMonitoredValues
)
{...}

Parameter

pUpdateMonitoredValues

[in] Zeigen Sie 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.

Bemerkungen

DxgkDdiUpdateMonitoredValues auf Geräteunterbrechungsebene ausgeführt und wird somit mit der überwachten signalisierten Interrupt-Dienstroutine (ISR) synchronisiert.

Die DxgkDdiUpdateMonitoredValues Implementierung einer KMD muss sicherstellen, dass die CurrentValue von jedem Prozessorkern gelesen, nachdem der Aufruf vom GPU-Kontextverwaltungsprozessor geschrieben wurde, nachdem der neue MonitoredValuebeobachtet wurde.

DxgkDdiUpdateMonitoredValues- wird erwartet, dass die UpdatedValueArray- Werte in den durch 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 vor oder nach dem Aufruf. Daher darf KMD diesen Zeiger niemals zwischenspeichern, um ihn an anderer Stelle zu verwenden.

Weitere Informationen zu systemeigenen GPU-Zaunen finden Sie unter native GPU-Zaunobjekte.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11, Version 24H2
Header- d3dkmddi.h
IRQL- PROFILE_LEVEL-1

Siehe auch

DXGKARG_UPDATEMONITOREDVALUES