DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdiSetDisplayPrivateDriverFormat--Funktion ändert das Attribut "Private-Format" einer Videodarstellungsquelle.

Syntax

DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT DxgkddiSetdisplayprivatedriverformat;

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

Parameter

[in] hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber, der zuvor dieses Handle für das Microsoft DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt hat.

[in] pSetDisplayPrivateDriverFormat

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

Rückgabewert

DxgkDdiSetDisplayPrivateDriverFormat gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird STATUS_UNSUCCESSFUL zurückgegeben, um anzugeben, dass der Treiber das Attribut "Private-Format" der angegebenen Videoquelle nicht ändern konnte.

Bemerkungen

Das DirectX-Grafik-Kernelsubsystem ruft die DxgkDdiSetDisplayPrivateDriverFormat Funktion des Anzeigetreibers des Anzeigetreibers für den Anzeigemodus den pfnSetDisplayPrivateDriverFormatCb Rückruffunktion auf. Beispielsweise kann der Anzeigetreiber im Benutzermodus pfnSetDisplayPrivateDriverFormatCb aufrufen, um das Swizzling-Format der Quelle für die Videodarstellung zu ändern, wenn eine Änderung im Vollbildmodus erstellt wird. Das DirectX-Grafik-Kernelsubsystem ruft dann die DxgkDdiSetDisplayPrivateDriverFormat- des Anzeigeminiporttreibers auf, um das Format des privaten Treibers der Videodarstellungsquelle zu ändern. Dadurch kann die primäre Zuordnung auf der Videodarstellungsquelle angezeigt werden, ohne dass die primäre Oberfläche übersetzt werden muss.

HinweisDxgkDdiSetDisplayPrivateDriverFormat nicht das Format des privaten Treibers anwendet, das das PrivateDriverFormatAttribute Member der DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT Struktur angibt, auf die von pSetDisplayPrivateDriverFormat für jede Zuordnung verwiesen wird. DxgkDdiSetDisplayPrivateDriverFormat wendet das Format des privaten Treibers direkt auf die Quelle der Videoanzeige an. Beispielsweise können DxgkDdiSetDisplayPrivateDriverFormat- die DAC-Registrierungen neu programmieren, um aus einem anderen Swizzling-Format zu scannen.

DxgkDdiSetDisplayPrivateDriverFormat- sollte seitenfähig gemacht werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	d3dkmddi.h
IRQL-	PASSIVE_LEVEL

Siehe auch

DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT

pfnSetDisplayPrivateDriverFormatCb

Freigeben über