DXGKDDI_UPDATEOVERLAY Rückruffunktion (d3dkmddi.h)
Die DxgkDdiUpdateOverlay-Funktion ändert die Überlagerungshardware.
Syntax
DXGKDDI_UPDATEOVERLAY DxgkddiUpdateoverlay;
NTSTATUS DxgkddiUpdateoverlay(
[in] IN_CONST_HANDLE hOverlay,
[in] IN_CONST_PDXGKARG_UPDATEOVERLAY pUpdateOverlay
)
{...}
Parameter
[in] hOverlay
Ein Handle für die zu ändernde Überlagerung. Die DxgkDdiCreateOverlay-Funktion des Anzeige-Miniporttreibers dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im hOverlay Member der DXGKARG_CREATEOVERLAY Struktur bereitgestellt, auf die pCreateOverlay verweist.
[in] pUpdateOverlay
Ein Zeiger auf eine DXGKARG_UPDATEOVERLAY-Struktur, die beschreibt, wie die Überlagerungshardware geändert wird.
Rückgabewert
DxgkDdiUpdateOverlay gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | DxgkDdiUpdateOverlay hat die Überlagerung erfolgreich geändert. |
| STATUS_INVALID_PARAMETER | Parameter, die an DxgkDdiUpdateOverlay übergeben wurden, enthielt Fehler, die das Abschließen verhinderten. |
| STATUS_NO_MEMORY | DxgkDdiUpdateOverlay konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war. |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiUpdateOverlay konnte nicht abgeschlossen werden, da nicht genügend Bandbreite verfügbar war oder die angeforderte Overlayhardware die Aufgabe nicht abschließen konnte. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Der Anzeigeminiporttreiber ist nicht mit dem Benutzermodusanzeigetreiber kompatibel, der den Aufruf an DxgkDdiUpdateOverlay initiiert hat. |
Bemerkungen
DxgkDdiUpdateOverlay sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |