PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL回呼函式 (d3dumddi.h)

ConfigureAuthenticatedChannel 函式會設定已驗證通道內的狀態。

語法

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

參數

hDevice

顯示裝置的句柄 (圖形內容) 。

unnamedParam2

pData [in， out]

描述如何設定已驗證通道 之D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL 結構的指標。 此結構包含輸入緩衝區，描述如何使用組態信息來設定已驗證的通道和輸出緩衝區。

傳回值

ConfigureAuthenticatedChannel 會傳回下列其中一個值：

備註

輸入緩衝區包含單鍵加密區塊鏈結 (CBC) 模式訊息驗證碼， (OMAC) 驅動程式必須驗證。 輸入緩衝區也包含驅動程式對已驗證通道的句柄、序號，以及指出組態類型的 GUID。

如果輸入 OMAC 不相符，則驅動程式應該會失敗 ConfigureAuthenticatedChannel ;如果序號不大於先前呼叫中指定的序號，或是序號尚未初始化， (這個最後一個規則的例外狀況是初始化呼叫本身) 。

驅動程式應該複製輸出緩衝區結構中的輸入數據，而且應該將輸出結構與目前處理 Output Protection Manager (OPM) 查詢的方式相同。

除了應用程式不正確地指定太小的輸出緩衝區以外，驅動程序應該一律將傳回碼放在輸出結構中。 因此，應用程式有安全的機制可判斷傳回碼。

ConfigureAuthenticatedChannel 會根據輸入結構中指定的每個 GUID 執行不同的作業。 如果輸入緩衝區大小不符合為指定 GUID 定義的大小，驅動程式應該會失敗。

規格需求

另請參閱

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL