PFND3DDDI_OFFERALLOCATIONSCB função de retorno de chamada (d3dumddi.h)
Chamado pelo driver de exibição do modo de usuário para oferecer alocações de memória de vídeo para reutilização.
Sintaxe
PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;
HRESULT Pfnd3dddiOfferallocationscb(
HANDLE hDevice,
const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico). O runtime do Direct3D passou o driver de modo de usuário desse identificador como o membro hDevice da estrutura D3DDDIARG_CREATEDEVICE na criação do dispositivo.
unnamedParam2
pData [in]
Um ponteiro para uma estrutura D3DDDICB_OFFERALLOCATIONS que define as alocações de memória de vídeo que o driver oferece.
Retornar valor
Retorna um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
| S_OK | As alocações foram oferecidas com êxito. Nota: Se o driver não precisar chamar pfnOfferAllocationsCb, ele deverá retornar S_OK. |
| D3DDDIERR_DEVICEREMOVED | O gerenciador de memória de vídeo ou o driver de miniporta de exibição não pôde concluir a operação porque ocorreu um evento de parada de Plug and Play (PnP) ou um evento TDR (Detecção e Recuperação de Tempo Limite). Nota: Se esse código de erro for retornado, a função de chamada do driver (normalmente a rotina pfnOfferResources ) deverá retornar esse código de erro para o runtime do Direct3D. |
| E_INVALIDARG | Um parâmetro inválido foi fornecido. |
Comentários
O driver de exibição do modo de usuário chama pfnOfferAllocationsCb para notificar o subsistema de kernel de elementos gráficos do Microsoft DirectX que, depois de concluir todas as operações de renderização enviadas anteriormente, ele pode oferecer a memória das alocações para outros processos usarem.
Depois que o driver chama pfnOfferAllocationsCb para oferecer uma alocação para reutilização, ele deve chamar pfnReclaimAllocationsCb antes de bloquear a alocação ou enviá-la para operações de renderização.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |