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

Artigo
02/06/2025

A função ResolveSharedResource informa a um driver de exibição no modo de usuário que a propriedade de uma superfície compartilhada foi alterada ou que uma superfície está sendo usada para interoperação GDI.

Sintaxe

PFND3DDDI_RESOLVESHAREDRESOURCE Pfnd3dddiResolvesharedresource;

HRESULT Pfnd3dddiResolvesharedresource(
  HANDLE hDevice,
  const D3DDDIARG_RESOLVESHAREDRESOURCE *unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (ou seja, o contexto gráfico) associado à superfície compartilhada ou à superfície interoperável GDI.

unnamedParam2

pData [in]

Um ponteiro para uma estrutura D3DDDIARG_RESOLVESHAREDRESOURCE que contém um identificador para a superfície.

Valor de retorno

ResolveSharedResource retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	O recurso foi resolvido com êxito.
D3DDDIERR_DEVICEREMOVED	O driver detecta que o adaptador gráfico foi removido. Portanto, o driver não concluiu a operação. Se o driver nunca observar a condição de remoção do adaptador, o driver não será necessário para retornar esse código de erro.

Observações

As chamadas de runtime do Direct3D ResolveSharedResource quando um aplicativo chama uma das seguintes funções:

IDXGIKeyedMutex::ReleaseSynch em uma superfície compartilhada sincronizada
IDXGISurface1::GetDC para uma superfície interoperável de GDI

O runtime chama a função ResolveSharedResource do driver sempre que um proprietário de superfície compartilhada é alterado ou quando uma superfície é usada para interoperação GDI. O runtime fornece ResolveSharedResource com identificadores para o dispositivo de exibição, por meio do parâmetro hDevice e da superfície, por meio do parâmetro pData.

O driver implementa ResolveSharedResource para gerenciar adequadamente os recursos para vários cenários de GPU. Cada recurso pode ser dividido em memória para várias GPUs a serem renderizadas. O driver pode implementar ResolveSharedResource para remergir cada recurso para que o novo proprietário do recurso tenha o recurso mesclado. O driver deve liberar buffers de comando parcialmente criados que possam modificar o recurso.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	O ResolveSharedResource tem suporte a partir do sistema operacional Windows 7.
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Consulte também

D3DDDIARG_RESOLVESHAREDRESOURCE

D3DDDI_DEVICEFUNCS

Partilhar via