PFND3DDDI_UNLOCK Rückruffunktion (d3dumddi.h)
Die Entsperren Funktion entsperrt eine Ressource oder eine Oberfläche innerhalb der Ressource, die zuvor durch die funktion Sperren gesperrt wurde.
Syntax
PFND3DDDI_UNLOCK Pfnd3dddiUnlock;
HRESULT Pfnd3dddiUnlock(
HANDLE hDevice,
const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in]
Ein Zeiger auf eine D3DDDIARG_UNLOCK Struktur, die die Ressource oder Oberfläche innerhalb der Zusperrung beschreibt.
Rückgabewert
Unlock gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Ressource wurde erfolgreich entsperrt. |
| E_OUTOFMEMORY | Die Entsperrung konnte den erforderlichen Arbeitsspeicher nicht zuordnen, damit er abgeschlossen werden kann. |
| E_INVALIDARG | Die ressource, die D3DDDIARG_UNLOCK beschreibt, wurde nicht durch einen vorherigen Aufruf der Lock-Funktion des Treibers gesperrt. |
Bemerkungen
Diese Kommentare entsprechen der Beschreibung im Abschnitt "Anmerkungen" der Sperre Referenzseite.
Der Anzeigetreiber für den Benutzermodus muss die pfnUnlockCb- Funktion der Microsoft Direct3D-Laufzeit aufrufen, nachdem Entsperren aufgerufen wurde. In diesem pfnUnlockCb Aufruf übergibt der Anzeigetreiber für den Benutzermodus ein Zuordnungshandle. Vor dem Aufrufen pfnUnlockCbmuss der Anzeigetreiber für den Benutzermodus zuerst die Oberfläche einer entsprechenden Zuordnung zuordnen.
Die Laufzeit ruft die Entsperrung Funktion des Benutzermodus auf, um auch vorinstallierte Systemspeicheroberflächen zu entsperren. Die Laufzeit legt die NotifyOnly Bitfeldkennzeichnung im Flags Element der D3DDDIARG_UNLOCK Struktur fest, auf die pData- verweist, um Entsperren von Aufrufen zu unterscheiden, die den vorab zugewiesenen Systemspeicher von anderen Entsperren von Aufrufen entsperren. Wenn die Lock--Funktion des Benutzermodus, die pfnLockCb aufgerufen wird,, um die Systemspeicherzuweisung zu sperren, die der Oberfläche entspricht, muss sie auch pfnUnlockCbaufrufen. Das Aufrufen pfnUnlockCb stoppt die Koordination zwischen der Laufzeit, dem Anzeigetreiber für den Benutzermodus und dem Anzeigeminiporttreiber.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Universal |
| Header- | d3dumddi.h (include D3dumddi.h) |