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

Artigo
02/06/2025

Insere um comando de espera para os objetos de sincronização especificados no fluxo de comando de contexto especificado. Usado pelo WDDM (Windows Display Driver Model) 1.2 e posteriores drivers de exibição do modo de usuário.

Sintaxe

PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Pfnd3dddiWaitforsynchronizationobject2cb;

HRESULT Pfnd3dddiWaitforsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 *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_WAITFORSYNCHRONIZATIONOBJECT2 que descreve os objetos de sincronização e o fluxo de DMA de contexto necessários para configurar a espera.

Valor de retorno

Retorna um dos seguintes valores:

Código de retorno	descrição
S_OK	A espera 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:

Não chame essa função se o objeto de sincronização for do tipo D3DDDI_CPU_NOTIFICATION— ou seja, o Type membro da estrutura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 tem um valor de D3DDDI_CPU_NOTIFICATION.pfnDestroySynchronizationObjectCb

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)