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 成員中指定的通道類型。 |
備註
運行時間會將句柄傳遞至驅動程式在D3DDDIARG_CREATEAUTHENTICATEDCHANNEL結構之ChannelType 成員中傳回的已驗證通道,而後續所有需要句柄的呼叫。
驅動程式必須追蹤用來建立已驗證通道的顯示裝置 (hDevice) 。 例如,如果這些呼叫中指定的顯示裝置與用來建立已驗證通道的顯示裝置不同,則驅動程式應該會失敗使用此已建立已驗證通道的所有後續呼叫 (AuthenticationdChannelKeyExchange 函式) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 7 操作系統開始,支援 CreateAuthenticatedChannel。 |
目標平台 | 桌面 |
標頭 | d3dumddi.h (包含 D3dumddi.h) |