PFND3DDDI_OFFERALLOCATIONS2CB função de retorno de chamada (d3dumddi.h)

Artigo
02/23/2024

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)