DXGKDDI_CREATEOVERLAY Rückruffunktion (d3dkmddi.h)

  • Artikel

Die DxgkDdiCreateOverlay-Funktion aktiviert die Überlagerungshardware, wenn die Hardware fähig ist.

Syntax

DXGKDDI_CREATEOVERLAY DxgkddiCreateoverlay;

NTSTATUS DxgkddiCreateoverlay(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_CREATEOVERLAY pCreateOverlay
)
{...}

Parameter

[in] hAdapter

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

[in/out] pCreateOverlay

Ein Zeiger auf eine DXGKARG_CREATEOVERLAY Struktur, die die Überlagerung beschreibt.

Rückgabewert

DxgkDdiCreateOverlay gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS DxgkDdiCreateOverlay hat das Overlay erfolgreich erstellt.
STATUS_INVALID_PARAMETER Parameter, die an DxgkDdiCreateOverlay übergeben wurden, enthielten Fehler, die den Abschluss verhinderten.
STATUS_NO_MEMORY DxgkDdiCreateOverlay konnte keinen Speicher zuordnen, der für die Vervollständigung erforderlich war.
STATUS_INSUFFICIENT_RESOURCES DxgkDdiCreateOverlay konnte nicht abgeschlossen werden, weil nicht genügend Bandbreite verfügbar war oder die angeforderte Overlayhardware die Aufgabe nicht abschließen konnte.
STATUS_GRAPHICS_DRIVER_MISMATCH Der Display-Miniporttreiber ist nicht mit dem Benutzermodus-Anzeigetreiber kompatibel, der den Aufruf von DxgkDdiCreateOverlay initiiert hat.

Hinweise

DxgkDdiCreateOverlay sollte seitenfähig gemacht werden.

Anforderungen

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

Weitere Informationen

DXGKARG_CREATEOVERLAY

DxgkDdiAddDevice