Compartir a través de


PFND3DDDI_OFFERALLOCATIONSCB 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_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

HRESULT Pfnd3dddiOfferallocationscb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS *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_OFFERALLOCATIONS 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 pfnOfferAllocationsCb, 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 de tiempo de espera (TDR).
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 pfnOfferAllocationsCb 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 los usen.

Después de que el controlador llame a pfnOfferAllocationsCb para ofrecer una asignación para reutilizarla, debe llamar a pfnReclaimAllocationsCb antes de bloquear la asignación o enviarlo para las operaciones de representación.

Requisitos

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

Consulte también

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb