共用方式為


PFND3DDDI_UNLOCK回呼函式 (d3dumddi.h)

Unlock 函式會解除鎖定資源或鎖定函式先前鎖定之資源內的介面。

語法

PFND3DDDI_UNLOCK Pfnd3dddiUnlock;

HRESULT Pfnd3dddiUnlock(
  HANDLE hDevice,
  const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}

參數

hDevice

顯示裝置的句柄 (圖形內容) 。

unnamedParam2

pData [in]

描述要解除鎖定之資源或介面之 D3DDDIARG_UNLOCK 結構的指標。

傳回值

Unlock 會傳回下列其中一個值:

傳回碼 描述
S_OK 已成功解除鎖定資源。
E_OUTOFMEMORY 解除鎖定無法配置所需的記憶體,使其完成。
E_INVALIDARG D3DDDIARG_UNLOCK描述的資源未由先前呼叫驅動程式的 Lock 函式鎖定。

備註

這些批注類似於 鎖定 參考頁面一節中的描述。

呼叫 Unlock 之後,使用者模式顯示驅動程式必須呼叫 Microsoft Direct3D 執行時間的 pfnUnlockCb 函式。 在此 pfnUnlockCb 呼叫中,使用者模式顯示驅動程式會傳遞配置句柄。 呼叫 pfnUnlockCb 之前,使用者模式顯示驅動程式必須先將表面對應至適當的配置。

運行時間也會呼叫使用者模式顯示驅動程式的 Unlock 函式,以解除鎖定預先配置的系統記憶體表面。 運行時間會在 pData 指向 D3DDDIARG_UNLOCK的Flags 成員中設定 NotifyOnly 位欄位字段旗標,以區分解除鎖定預先配置系統記憶體的解除鎖定呼叫與其他 Unlock 呼叫。 如果使用者模式顯示驅動程式的 Lock 函式,稱為 pfnLockCb 來鎖定對應至表面的系統記憶體配置,它也必須呼叫 pfnUnlockCb。 未呼叫 pfnUnlockCb 會停止運行時間、使用者模式顯示驅動程式和顯示器迷你埠驅動程式之間的協調。

規格需求

需求
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 Universal
標頭 d3dumddi.h (包含 D3dumddi.h)

另請參閱

D3DDDIARG_UNLOCK

D3DDDI_DEVICEFUNCS

鎖定

pfnLockCb

pfnUnlockCb