PFND3DDDI_OFFERALLOCATIONS2CB 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_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;
HRESULT Pfnd3dddiOfferallocations2cb(
HANDLE hDevice,
const D3DDDICB_OFFERALLOCATIONS2 *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico). O runtime do Direct3D passou o driver do 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_OFFERALLOCATIONS2 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 pfnOfferAllocations2Cb , 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 puderam 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 pfnOfferAllocations2Cb para notificar o subsistema de kernel de elementos gráficos do Microsoft DirectX que, depois de concluir quaisquer 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 pfnOfferAllocations2Cb para oferecer uma alocação para reutilizar, ele deve chamar pfnReclaimAllocations3Cb antes de bloquear a alocação ou enviá-la para operações de renderização.
pfnOfferAllocations2Cb funciona de forma idêntica a pfnOfferAllocationsCb, exceto que ele leva os sinalizadores em conta por meio do parâmetro pData.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10 |
| Servidor mínimo com suporte | Windows Server 2016 |
| Plataforma de Destino | Windows |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |