PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB回呼函式（d3dumddi.h）

發行項
02/06/2025

在指定的內容直接記憶體存取（DMA）資料流中，於指定的同步處理物件上插入訊號。 WDDM 1.2 和更新版本的使用者模式顯示驅動程式使用。

語法

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

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

參數

hDevice

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

unnamedParam2

pData [in]

D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 結構的指標，描述已設定訊號的同步處理對象和內容 DMA 數據流。

傳回值

傳回下列其中一個值：

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

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

言論

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

pfnSignalSynchronizationObject2Cb 函式會將訊號命令提交至 hContext 所指定之所有 Microsoft Direct3D 內容的命令數據流，以及 BroadcastContextD3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 結構的成員。只有在處理所有提交的訊號命令時，才會發出同步處理物件訊號。

如果同步處理物件的類型為 D3DDDI_FENCE （其中 D3DDDI_SYNCHRONIZATIONOBJECTINFO2.Type = D3DDDI_FENCE），則必須一次只提交一個，並 D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2。ObjectCount 的值必須為 1。