PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB回呼函式 (d3dumddi.h)

發行項
02/23/2024

在指定的內容直接記憶體存取 (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 函式會將核心模式句柄傳回至 pData 參數指向之D3DDDICB_CREATESYNCHRONIZATIONOBJECT2結構之 hSyncObject 成員中新建立的同步處理物件。使用者模式顯示驅動程式會將此句柄傳遞至下列函式的呼叫：

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

如果同步處理對象的類型D3DDDI_FENCE (D3DDDI_SYNCHRONIZATIONOBJECTINFO2。類型 = D3DDDI_FENCE) ，一次只能提交一個，D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2。ObjectCount 的值必須為 1。