DXGKDDI_UPDATEOVERLAY Rückruffunktion (d3dkmddi.h)
Die DxgkDdiUpdateOverlay-Funktion ändert die Overlayhardware.
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 Anzeigeminiporttreibers hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsubsystem im hOverlay-Element 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, enthielten Fehler, die den Abschluss verhinderten. |
| STATUS_NO_MEMORY | DxgkDdiUpdateOverlay konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war. |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiUpdateOverlay 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 Anzeigetreiber im Benutzermodus kompatibel, der den Aufruf von DxgkDdiUpdateOverlay initiiert hat. |
Hinweise
DxgkDdiUpdateOverlay sollte als ausgelagert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |