PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL回呼函式 （d3dumddi.h）
ConfigureAuthenticatedChannel 函式會設定已驗證通道內的狀態。
語法
PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;
HRESULT Pfnd3dddiConfigureauthenicatedchannel(
HANDLE hDevice,
const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄（圖形內容）。
unnamedParam2
pData [in， out]
描述如何設定已驗證通道之 D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL 結構的指標。 此結構包含輸入緩衝區，描述如何使用組態信息來設定已驗證的通道和輸出緩衝區。
傳回值
ConfigureAuthenticatedChannel 會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| S_OK | 驗證的通道已成功設定。 |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel 無法為其配置所需的記憶體來完成。 |
言論
輸入緩衝區包含驅動程式必須驗證的一鍵加密區塊鏈結 （CBC）模式訊息驗證碼 （OMAC）。 輸入緩衝區也包含已驗證通道的驅動程式句柄、序號，以及指出組態類型的 GUID。
如果輸入 OMAC 不相符，則驅動程式應該會失敗 ConfigureAuthenticatedChannel，如果序號不大於先前呼叫中指定的序號，或序號尚未初始化，則為 （這個最後一個規則的例外狀況是初始化呼叫本身）。
驅動程式應該複製輸出緩衝區結構中的輸入數據，而且應該將輸出結構與目前如何處理 輸出保護管理員 （OPM） 查詢的方式相同。
除了應用程式不正確地指定太小的輸出緩衝區以外，驅動程序應該一律將傳回碼放在輸出結構中。 因此，應用程式有安全的機制可判斷傳回碼。
ConfigureAuthenticatedChannel 會根據輸入結構中指定的每個 GUID 來執行不同的作業。 如果輸入緩衝區大小不符合為指定 GUID 定義的大小，驅動程式應該會失敗。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 7作系統開始，支援 ConfigureAuthenticatedChannel。 |
| 目標平臺 | 桌面 |
| 標頭 | d3dumddi.h （包括 D3dumddi.h） |