PFND3DDDI_CREATEAUTHENTICATEDCHANNEL回呼函式 （d3dumddi.h）
CreateAuthenticatedChannel 函式會建立通道，讓 Microsoft Direct3D 運行時間和驅動程式可用來設定和查詢保護。
語法
PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;
HRESULT Pfnd3dddiCreateauthenticatedchannel(
HANDLE hDevice,
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄（圖形內容）。
unnamedParam2
pData [in， out]
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 結構的指標。 在輸入時，此結構包含驅動程式可以使用的資訊。 在輸出時，驅動程式會指定 Direct3D 執行時間可以使用之 結構中的資訊。
傳回值
CreateAuthenticatedChannel 會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| S_OK | 已成功建立通道。 |
| E_OUTOFMEMORY | CreateAuthenticatedChannel 無法為其配置所需的記憶體來完成。 |
| D3DDDIERR_NOTAVAILABLE | 驅動程式不支援 pData 參數指向之 D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 結構的 ChannelType 成員中指定的通道類型。 |
言論
運行時間會將句柄傳遞給驅動程式在 ChannelType 中傳回的已驗證通道， 所有需要句柄的後續呼叫中 D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 結構的成員。
驅動程式必須追蹤用來建立已驗證通道的顯示裝置（hDevice）。 如果這些呼叫中指定的顯示裝置與用來建立已驗證通道的顯示裝置不同，驅動程式應該會失敗所有使用此已建立已驗證通道的後續呼叫（例如，AuthenticatedChannelKeyExchange 函式）。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 7作系統開始，支援 CreateAuthenticatedChannel。 |
| 目標平臺 | 桌面 |
| 標頭 | d3dumddi.h （包括 D3dumddi.h） |