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)

Consulte también

D3DDDIARG_UNLOCK

D3DDDI_DEVICEFUNCS

Bloquear

pfnLockCb

pfnUnlockCb