PFND3DDDI_UNLOCK Rückruffunktion (d3dumddi.h)
Die Unlock-Funktion entsperrt eine Ressource oder eine Oberfläche innerhalb der Ressource, die zuvor durch die Lock-Funktion 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 zu entsperrenden Ressource beschreibt.
Rückgabewert
Unlock gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Ressource wurde erfolgreich entsperrt. |
| E_OUTOFMEMORY | Entsperren konnte den erforderlichen Arbeitsspeicher nicht zuordnen. |
| E_INVALIDARG | Die ressource, die D3DDDIARG_UNLOCK beschreibt, wurde nicht durch einen vorherigen Aufruf der Lock-Funktion des Treibers gesperrt. |
Hinweise
Diese Kommentare entsprechen der Beschreibung im Abschnitt Hinweise auf der Seite Verweis sperren.
Der Benutzermodusanzeigetreiber muss die PfnUnlockCb-Funktion der Microsoft Direct3D-Runtime aufrufen, nachdem Unlock aufgerufen wurde. In diesem pfnUnlockCb-Aufruf übergibt der Benutzermodusanzeigetreiber ein Zuordnungshandle. Vor dem Aufrufen von pfnUnlockCb muss der Benutzermodusanzeigetreiber die Oberfläche zunächst einer entsprechenden Zuordnung zuordnen.
Die Runtime ruft die Entsperrungsfunktion des Benutzermodusanzeigetreibers auf, um auch vorab zugeordnete Systemspeicheroberflächen zu entsperren. Die Runtime legt das Bitfeldflag NotifyOnly im Flags-Member der D3DDDIARG_UNLOCK-Struktur fest, auf das von pData verwiesen wird, um Entsperraufrufe zu unterscheiden, die den vorab zugewiesenen Systemspeicher von anderen Unlock-Aufrufen entsperren. Wenn der Benutzermodus die Lock-Funktion des Treibers mit dem Namen pfnLockCb anzeigt, um die Systemspeicherzuordnung zu sperren, die der Oberfläche entspricht, muss auch pfnUnlockCb aufgerufen werden. PfnUnlockCb wird nicht aufgerufen, um die Koordination zwischen der Runtime, dem Benutzermodusanzeigetreiber und dem Anzeigeminiporttreiber zu beenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | d3dumddi.h (include D3dumddi.h) |