PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB función de devolución de llamada (d3dumddi.h)

Artículo
02/23/2024

Inserta un comando wait para los objetos de sincronización especificados en el flujo de comandos de contexto especificado. Usado por windows Display Driver Model (WDDM) 1.2 y controladores de pantalla en modo usuario posteriores.

Sintaxis

PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Pfnd3dddiWaitforsynchronizationobject2cb;

HRESULT Pfnd3dddiWaitforsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

Parámetros

hDevice

Identificador de un dispositivo de pantalla (es decir, el contexto de gráficos).

unnamedParam2

pData [in]

Puntero a una estructura de D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 que describe los objetos de sincronización y el flujo de DMA de contexto necesarios para configurar la espera.

Valor devuelto

Devuelve uno de los valores siguientes:

Código devuelto	Descripción
S_OK	La espera se configuró correctamente.
E_INVALIDARG	Los parámetros se validaron y determinaron que son incorrectos.

Esta función también puede devolver otros valores HRESULT.

Comentarios

La función pfnCreateSynchronizationObject2Cb devuelve un identificador en modo kernel al objeto de sincronización recién creado en el miembro hSyncObject de la estructura D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 a la que apunta el parámetro pData . El controlador de pantalla en modo de usuario pasa este identificador en llamadas a las siguientes funciones:

No llame a esta función si el objeto de sincronización es de tipo D3DDDI_CPU_NOTIFICATION, es decir, el miembro Type de la estructura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 tiene un valor de D3DDDI_CPU_NOTIFICATION. pfnDestroySynchronizationObjectCb

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)