DXGKDDI_CREATEOVERLAY Rückruffunktion (d3dkmddi.h)
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 |