PFND3DDDI_UNLOCKCB función de devolución de llamada (d3dumddi.h)

Artículo
03/08/2023

La función pfnUnlockCb desbloquea una asignación bloqueada por una llamada a la función pfnLockCb .

Sintaxis

PFND3DDDI_UNLOCKCB Pfnd3dddiUnlockcb;

HRESULT Pfnd3dddiUnlockcb(
  HANDLE hDevice,
  const D3DDDICB_UNLOCK *unnamedParam2
)
{...}

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

pData [in]

Puntero a una estructura de D3DDDICB_UNLOCK que describe la asignación para desbloquear.

Valor devuelto

pfnUnlockCb devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	La asignación se desbloqueó correctamente.
E_OUTOFMEMORY	pfnUnlockCb no se pudo completar debido a memoria insuficiente. (Este error se produce cuando el sistema está en una situación de memoria extrema baja y no hay suficiente espacio para asignar la matriz de páginas).
E_INVALIDARG	Los parámetros se validaron y determinaron que son incorrectos.

Esta función también puede devolver otros valores HRESULT.

Comentarios

El controlador de pantalla en modo de usuario debe llamar a la función pfnUnlockCb para desbloquear una asignación bloqueada anteriormente en una llamada a la función pfnLockCb . Si el controlador no llama a pfnUnlockCb, se pierde la coordinación entre el entorno de ejecución de Microsoft Direct3D, el controlador de pantalla en modo usuario y el controlador de minipuerto de pantalla.

El controlador de pantalla en modo de usuario normalmente llama a pfnUnlockCb en respuesta a una llamada a su función Unlock o ResourceUnmap (u otras variaciones de ResourceUnmap , como DynamicIABufferUnmap) para desbloquear un recurso o una superficie dentro del recurso. Antes de volver desde la llamada Unlock o ResourceUnmap , el controlador de pantalla en modo de usuario debe asignar primero el recurso o la superficie a la asignación adecuada y, a continuación, llamar a pfnUnlockCb para desbloquear la asignación.

El controlador de pantalla en modo de usuario también puede llamar a pfnUnlockCb en respuesta a una llamada a su función DestroyDevice o DestroyDevice(D3D10) para liberar todos los recursos que asignó para el dispositivo. En la duración de un dispositivo, todas las llamadas a pfnLockCb para bloquear una asignación se deben emparejar con una llamada a la función pfnUnlockCb para desbloquear la asignación.

El controlador de pantalla en modo de usuario puede desbloquear varias asignaciones en una llamada a pfnUnlockCb estableciendo el miembro NumAllocations de la estructura D3DDDICB_UNLOCK en el número de asignaciones de la matriz especificada por el miembro phAllocations de D3DDDICB_UNLOCK.

El controlador de pantalla en modo de usuario debe llamar a pfnUnlockCb para desbloquear todas las asignaciones a las que se hace referencia en el flujo de comandos antes de llamar a la función pfnRenderCb . El controlador podría tener asignaciones bloqueadas para admitir, por ejemplo, la marca de campo de bits NoOverwrite . Si el controlador no desbloquea todas estas asignaciones, es posible que sea necesario que el administrador de memoria de vídeo coloque estas asignaciones en la memoria de AGP.

El controlador de pantalla en modo usuario no debe llamar a pfnUnlockCb para desbloquear una asignación que una aplicación podría usar. Se notifica al controlador que la aplicación ya no lee ni escribe en la asignación cuando el controlador recibe una llamada a su función Unlock o ResourceUnmap en el recurso correspondiente.

Ejemplos

En el ejemplo de código siguiente se muestra cómo desbloquear una asignación.

HRESULT CD3DContext::SyncEnginesUsingLock(VOID) {
    HRESULT hr;
    D3DDDICB_LOCK   lockCB;
    D3DDDICB_UNLOCK Unlock;

    memset(&lockCB, 0, sizeof(D3DDDICB_LOCK));
    lockCB.hAllocation = m_HandleUsedInLastSubmit;
    lockCB.PrivateDriverData = 0;                       
    hr = m_d3dCallbacks.pfnLockCb(m_hD3D, &lockCB);
    if (FAILED(hr)) {
        DBG_BREAK;
        return hr;
    }
    Unlock.NumAllocations = 1;
    Unlock.phAllocations = &m_HandleUsedInLastSubmit;
    m_d3dCallbacks.pfnUnlockCb(m_hD3D, &Unlock);   
    return hr;
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)