Compartir a través de


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

Lo llama el controlador de pantalla en modo de usuario para ofrecer asignaciones de memoria de vídeo para su reutilización.

Sintaxis

PFND3DDDI_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;

HRESULT Pfnd3dddiOfferallocations2cb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS2 *unnamedParam2
)
{...}

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos). El tiempo de ejecución de Direct3D pasó el controlador en modo de usuario este identificador como miembro hDevice de la estructura de D3DDDIARG_CREATEDEVICE en la creación del dispositivo.

unnamedParam2

pData [in]

Puntero a una estructura de D3DDDICB_OFFERALLOCATIONS2 que define las asignaciones de memoria de vídeo que ofrece el controlador.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK Las asignaciones se ofrecieron correctamente.
Nota: Si el controlador no necesita llamar a pfnOfferAllocations2Cb , debe devolver S_OK.
D3DDDIERR_DEVICEREMOVED El administrador de memoria de vídeo o el controlador de minipuerto de pantalla no pudieron completar la operación porque se produjo un evento de detención de Plug and Play (PnP) o un evento de detección y recuperación (TDR) de tiempo de espera.
Nota: Si se devuelve este código de error, la función de llamada del controlador (normalmente la rutina pfnOfferResources ) debe devolver este código de error al tiempo de ejecución de Direct3D.
E_INVALIDARG Se proporcionó un parámetro no válido.

Comentarios

El controlador de pantalla en modo de usuario llama a pfnOfferAllocations2Cb para notificar al subsistema del kernel de gráficos de Microsoft DirectX que, después de completar las operaciones de representación enviadas anteriormente, puede ofrecer la memoria de las asignaciones para que otros procesos usen.

Una vez que el controlador llama a pfnOfferAllocations2Cb para ofrecer una asignación para reutilizarla, debe llamar a pfnReclaimAllocations3Cb antes de bloquear la asignación o enviarlo para las operaciones de representación.

pfnOfferAllocations2Cb funciona de forma idéntica a pfnOfferAllocationsCb, salvo que tiene marcas en cuenta a través del parámetro pData.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS2

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocations3Cb