D3DKMTSharedPrimaryLockNotification-Funktion (d3dkmthk.h)
Die Funktion D3DKMTSharedPrimaryLockNotification benachrichtigt das Betriebssystem über eine bevorstehende Sperre für eine freigegebene primäre Oberfläche.
Syntax
NTSTATUS D3DKMTSharedPrimaryLockNotification(
[in] const D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION *unnamedParam1
);
Parameter
[in] unnamedParam1
Ein Zeiger auf eine D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION Struktur, die die freigegebene primäre Oberfläche beschreibt, die von einer Anwendung gesperrt wird.
Rückgabewert
D3DKMTSharedPrimaryLockNotification gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Benachrichtigung über eine bevorstehende Sperre für eine freigegebene primäre Oberfläche wurde erfolgreich ausgeführt. |
| STATUS_NO_MEMORY | D3DKMTSharedPrimaryLockNotification konnte aufgrund von unzureichendem Arbeitsspeicher nicht abgeschlossen werden. |
| STATUS_INVALID_PARAMETER | Parameter wurden überprüft und als falsch ermittelt. |
Diese Funktion kann auch andere NTSTATUS-Werte zurückgeben, die in Ntstatus.h definiert sind.
Hinweise
Der OpenGL ICD ruft die D3DKMTSharedPrimaryLockNotification-Funktion auf, um das Betriebssystem darüber zu informieren, dass eine Anwendung die freigegebene primäre GDI-Oberfläche sperren wird, die auf der Grafikkarte und der Videoquelle vorhanden ist, die die AdapterLuid - und VidPnSourceId-Member der D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION Struktur angeben. Der OpenGL-ICD muss D3DKMTSharedPrimaryLockNotification aufrufen, bevor die D3DKMTLock-Funktion für die freigegebene primäre GDI-Oberfläche aufgerufen wird, um sicherzustellen, dass das Betriebssystem alle Sprites deaktiviert, die sich mit dem Sperrbereich überschneiden, den das LockRect-Mitglied von D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Universell |
| Header | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |