DXGKDDI_SETTIMINGSFROMVIDPN Rückruffunktion (d3dkmddi.h)

  • Artikel

DXGKDDI_SETTIMINGSFROMVIDPN wird aufgerufen, um die Anzeigedauern auf einem Adapter festzulegen oder zu ändern. Dieser DDI ersetzt DxgkDdiCommitVidPn.

Syntax

DXGKDDI_SETTIMINGSFROMVIDPN DxgkddiSettimingsfromvidpn;

NTSTATUS DxgkddiSettimingsfromvidpn(
  [in]      IN_CONST_HANDLE hAdapter,
  [in, out] IN_OUT_PDXGKARG_SETTIMINGSFROMVIDPN pSetTimings
)
{...}

Parameter

[in] hAdapter

Gibt den Adapter an, für den die Anzeigezeiten festgelegt werden sollen.

[in, out] pSetTimings

Ein Zeiger auf eine DXGKARG_SETTIMINGSFROMVIDPN Struktur, die die festzulegenden Anzeigezeiten beschreibt.

Rückgabewert

Wenn diese Routine erfolgreich ist, wird STATUS_SUCCESS zurückgegeben.

Hinweis Der Treiber sollte immer einen Erfolgscode zurückgeben, es sei denn, es liegt ein Fehler in den Parametern oder ein Fehler bei der Verarbeitung der Anforderung vor. Wenn der Treiber einen oder mehrere Pfade nicht wie angefordert festlegen kann, sollte er die Bedingung mithilfe der Ausgabefelder beschreiben, aber trotzdem einen Erfolg melden.
 

Hinweise

Der Kernelmodustreiber wertet die Parameter aus und initiiert die Änderungen, wenn keine Bedingungen den Versuch verhindern. Wenn Bedingungen wie das Überschreiten der Zielbandbreitenbeschränkungen verhindern, dass die Änderungen vorgenommen werden, sollte der Treiber die Bedingungen beschreiben. Wenn das Ändern der Zeitangaben möglich wäre, aber zunächst Vorbereitungsarbeiten erforderlich sind, sollte der Treiber dies in den Ausgabeflags angeben.

Diese Funktion wird immer auf passiver Ebene aufgerufen.

Diese Funktion wird von DriverEntry des Anzeigeminiporttreibers registriert.

Ab WDDM 2.6 gibt das Betriebssystem an, dass die Anzeigen im DXGKDDI_SETTIMINGSFROMVIDPN-Aufruf synchronisiert werden sollen, wenn die Anzeigesynchronisierung verfügbar ist und mehrere Anzeigen aktiviert werden sollen. Jeder zu synchronisierende Pfad weist im Bitfeld SyncLockGroup einen Wert ungleich 0 (null) und im SyncLockStyle-Feld den ausgewählten Synchronisierungsstil auf, die sich beide in der DXGK_SET_TIMING_PATH_INFO Struktur befinden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3dkmddi.h
IRQL PASSIVE_LEVEL