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) |