DXGKDDI_CREATEOVERLAY Rückruffunktion (d3dkmddi.h)
Die DxgkDdiCreateOverlay-Funktion ermöglicht 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 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/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 die Überlagerung erfolgreich erstellt. |
| STATUS_INVALID_PARAMETER | Parameter, die an DxgkDdiCreateOverlay übergeben wurden, enthielt Fehler, die das Abschließen verhinderten. |
| STATUS_NO_MEMORY | DxgkDdiCreateOverlay konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war. |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiCreateOverlay 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 von DxgkDdiCreateOverlay initiiert hat. |
Bemerkungen
DxgkDdiCreateOverlay sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |