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