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

Artigo
02/26/2024

Insere um comando de espera para os objetos de sincronização especificados no fluxo de comando de contexto especificado. Usado pelo WDDM (Modelo de Driver de Exibição do Windows) 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.

Retornar valor

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.

Comentários

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 para a 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 membro Type da estrutura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 tiver um valor de D3DDDI_CPU_NOTIFICATION. pfnDestroySynchronizationObjectCb

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)