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 no modo de usuário que esse identificador é o hDevice membro da estrutura D3DDDIARG_CREATEDEVICE na criação do dispositivo.
unnamedParam2
pData [in]
Um ponteiro para uma estrutura de D3DDDICB_OFFERALLOCATIONS que define as alocações de memória de vídeo oferecidas pelo driver.
Valor de retorno
Retorna um dos seguintes valores.
| Código de retorno | descrição |
|---|---|
| S_OK | As alocações foram oferecidas com êxito. Observação: 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 miniporto 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). Observação: Se esse código de erro for retornado, a função de chamada do driver (normalmente a rotina de pfnOfferResources) deverá retornar esse código de erro para o runtime do Direct3D. |
| E_INVALIDARG | Um parâmetro inválido foi fornecido. |
Observações
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 as operações de renderização enviadas anteriormente, ele pode oferecer a memória das alocações para outros processos a serem usados.
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 |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| servidor com suporte mínimo | Windows Server 2012 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |