DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die DxgkDdiSetDisplayPrivateDriverFormat-Funktion ändert das Private-format-Attribut einer vorhandenen Videoquelle.

Syntax

DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT DxgkddiSetdisplayprivatedriverformat;

NTSTATUS DxgkddiSetdisplayprivatedriverformat(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT pSetDisplayPrivateDriverFormat
)
{...}

Parameter

[in] hAdapter

Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.

[in] pSetDisplayPrivateDriverFormat

Ein Zeiger auf eine DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT-Struktur , die Funktionsargumente enthält.

Rückgabewert

DxgkDdiSetDisplayPrivateDriverFormat gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird STATUS_UNSUCCESSFUL zurückgegeben, um anzugeben, dass der Treiber das Private-Format-Attribut der angegebenen Videoquelle nicht ändern konnte.

Hinweise

Das DirectX-Grafikkernsubsystem ruft die DxgkDdiSetDisplayPrivateDriverFormat-Funktion des Anzeigeminiporttreibers auf, nachdem der Anzeigetreiber im Benutzermodus die Rückruffunktion pfnSetDisplayPrivateDriverFormatCb aufgerufen hat. Der Anzeigetreiber im Benutzermodus könnte beispielsweise pfnSetDisplayPrivateDriverFormatCb aufrufen, um das Swizzlingformat der vorhandenen Videoquelle zu ändern, wenn eine Vollbild-Flipping-Änderung erstellt wird. Das DirectX-Grafikkernsubsystem ruft dann dxgkDdiSetDisplayPrivateDriverFormat des Anzeige-Miniporttreibers auf, um das Private-Driver-Format der vorhandenen Videoquelle zu ändern. Dadurch kann die primäre Zuordnung auf der aktuellen Videoquelle angezeigt werden, ohne dass eine Übersetzung der primären Oberfläche erforderlich ist.

HinweisDxgkDdiSetDisplayPrivateDriverFormat wendet nicht das PrivateDriverFormat-Format an, das das PrivateDriverFormatAttribute-Element der DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT Struktur angibt, auf die von pSetDisplayPrivateDriverFormat verwiesen wird. DxgkDdiSetDisplayPrivateDriverFormat wendet das Format des privaten Treibers direkt auf die vorliegende Videoquelle an. Beispielsweise kann DxgkDdiSetDisplayPrivateDriverFormat die DAC-Register neu programieren, um sie aus einem anderen Swizzling-Format zu scannen.

DxgkDdiSetDisplayPrivateDriverFormat sollte als ausgelagert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Weitere Informationen

DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT

pfnSetDisplayPrivateDriverFormatCb

Freigeben über