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 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 de retorno | 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 miniporte de pantalla no pudieron completar la operación porque se produjo un evento Plug and Play (PnP) Stop 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. |
Observaciones
El controlador de visualización 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 usen otros procesos.
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 | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| servidor mínimo admitido | Windows Server 2012 |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |