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

Artigo
02/06/2025

Insere um sinal nos objetos de sincronização especificados no fluxo de DMA (acesso direto à memória) de contexto especificado. Usado pelo WDDM 1.2 e por drivers de exibição do modo de usuário posterior.

Sintaxe

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

HRESULT Pfnd3dddiSignalsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para um dispositivo de exibição (ou seja, o contexto gráfico).

unnamedParam2

pData [in]

Um ponteiro para uma estrutura D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 que descreve os objetos de sincronização e o fluxo de DMA de contexto em que a sinalização está configurada.

Valor de retorno

Retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	A sinalização foi configurada com êxito.
E_INVALIDARG	Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores HRESULT.

Observações

A função pfnCreateSynchronizationObject2Cb retorna um identificador de modo kernel para o objeto de sincronização recém-criado no membro hSyncObject da estrutura D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 à qual o parâmetro pData aponta. O driver de exibição do modo de usuário passa esse identificador em chamadas para as seguintes funções:

A função pfnSignalSynchronizationObject2Cb envia um comando de sinal para o fluxo de comando de todos os contextos do Microsoft Direct3D especificados pelo hContext e BroadcastContext membros da estrutura D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2. Os objetos de sincronização são sinalizados somente quando todos os comandos de sinal enviados são processados.

Se os objetos de sincronização forem do tipo D3DDDI_FENCE (em que D3DDDI_SYNCHRONIZATIONOBJECTINFO2.Tipo = D3DDDI_FENCE), eles deverão ser enviados apenas um de cada vez e D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2.ObjectCount deve ter um valor de 1.

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)

Consulte também

D3DDDICB_CREATESYNCHRONIZATIONOBJECT2

D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2

pfnCreateSynchronizationObject2Cb

pfnDestroySynchronizationObjectCb

pfnWaitForSynchronizationObject2Cb

Partilhar via