D3DKMTSharedPrimaryLockNotification-Funktion (d3dkmthk.h)
Die D3DKMTSharedPrimaryLockNotification funktion benachrichtigt das Betriebssystem über eine bevorstehende Sperre an eine gemeinsam genutzte 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 | Benachrichtigung über eine bevorstehende Sperre für eine freigegebene primäre Oberfläche wurde erfolgreich ausgeführt. |
| STATUS_NO_MEMORY | D3DKMTSharedPrimaryLockNotification konnte aufgrund unzureichendem Arbeitsspeicher nicht abgeschlossen werden. |
| STATUS_INVALID_PARAMETER | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
Diese Funktion kann auch andere NTSTATUS- Werte zurückgeben, die in Ntstatus.h definiert sind.
Bemerkungen
Die 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 soll, die auf dem Grafikadapter und Video vorhanden ist, die Quelle, die die AdapterLuid und VidPnSourceId Member der D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION Struktur angeben. Die 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Universal |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |