PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB回呼函式（d3dumddi.h）

發行項
02/06/2025

在指定的內容命令數據流中，插入指定之同步處理物件的等候命令。 Windows 顯示驅動程式模型（WDDM） 1.2 和更新版本的使用者模式顯示驅動程式使用。

語法

PFND3DDDI_WAITFORSYNCHRONIZATIONOBJECT2CB Pfnd3dddiWaitforsynchronizationobject2cb;

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

參數

hDevice

顯示裝置的句柄（也就是圖形內容）。

unnamedParam2

pData [in]

D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 結構的指標，描述設定等候所需的同步處理對象和內容 DMA 數據流。

傳回值

傳回下列其中一個值：

傳回碼	描述
S_OK	已成功設定等候。
E_INVALIDARG	已驗證參數，並判斷為不正確。

此函式也可能傳回其他 HRESULT 值。

言論

pfnCreateSynchronizationObject2Cb 函式會將內核模式句柄傳回 hSyncObject 中新建立的同步處理物件，pData 參數指向之 D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 結構的成員。使用者模式顯示驅動程式會在呼叫下列函式時傳遞此句柄：

如果同步處理對象的類型為 D3DDDI_CPU_NOTIFICATION，請勿呼叫此函式，也就是 D3DDDI_SYNCHRONIZATIONOBJECTINFO2 結構 Type 成員具有 D3DDDI_CPU_NOTIFICATION值。pfnDestroySynchronizationObjectCb