PFND3DDDI_UNLOCK función de devolución de llamada (d3dumddi.h)
La función Unlock desbloquea un recurso o una superficie dentro del recurso bloqueado previamente por la función Lock .
Sintaxis
PFND3DDDI_UNLOCK Pfnd3dddiUnlock;
HRESULT Pfnd3dddiUnlock(
HANDLE hDevice,
const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in]
Puntero a una estructura de D3DDDIARG_UNLOCK que describe el recurso o superficie dentro del recurso que se va a desbloquear.
Valor devuelto
Unlock devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | El recurso se desbloquea correctamente. |
| E_OUTOFMEMORY | El desbloqueo no pudo asignar la memoria necesaria para que se complete. |
| E_INVALIDARG | El recurso que D3DDDIARG_UNLOCK describe no estaba bloqueado por una llamada anterior a la función Lock del controlador. |
Comentarios
Estos comentarios son análogos a la descripción de la sección Comentarios de la página Referencia de bloqueo .
El controlador de pantalla en modo de usuario debe llamar a la función pfnUnlockCb del entorno de ejecución de Microsoft Direct3D después de llamar a Unlock . En esta llamada pfnUnlockCb , el controlador de pantalla en modo de usuario pasa un identificador de asignación. Antes de llamar a pfnUnlockCb, el controlador de pantalla en modo de usuario debe asignar primero la superficie a una asignación adecuada.
El tiempo de ejecución llama también a la función Unlock del controlador de pantalla en modo de usuario para desbloquear las superficies de memoria del sistema asignadas previamente. El tiempo de ejecución establece la marca de campo de bits NotifyOnly en el miembro Flags de la estructura de D3DDDIARG_UNLOCK a la que apunta pData para diferenciar las llamadas Unlock que desbloquean la memoria del sistema asignada previamente de otras llamadas unlock . Si la función Lock del controlador de pantalla en modo de usuario llamada pfnLockCb para bloquear la asignación de memoria del sistema que corresponde a la superficie, también debe llamar a pfnUnlockCb. No llamar a pfnUnlockCb detiene la coordinación entre el tiempo de ejecución, el controlador de pantalla en modo de usuario y el controlador de minipuerto de pantalla.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |