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