共用方式為


PFND3DDDI_UNLOCK回呼函式 (d3dumddi.h)

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

語法

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 函式鎖定。

言論

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

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

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

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺 普遍
標頭 d3dumddi.h (包括 D3dumddi.h)

另請參閱

D3DDDIARG_UNLOCK

D3DDDI_DEVICEFUNCS

鎖定

pfnLockCb

pfnUnlockCb