PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL回呼函式 （d3d10umddi.h）
建立已驗證的通道物件。 由 Windows 顯示驅動程式模型 （WDDM） 1.2 或更新版本的使用者模式顯示驅動程序實作。
語法
PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;
HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}
參數
hDevice
顯示裝置的句柄（圖形內容）。
pCreateData
D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL 結構的指標。 此結構會指定要建立之已驗證通道的屬性。
hAuthChannel
已驗證通道對象的驅動程式私用數據的句柄。 如需詳細資訊，請參閱一節。
hRTAuthChannel
驅動程式回呼 Direct3D 執行時間時，應該使用的已驗證通道物件的句柄。
傳回值
傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| S_OK | 已成功建立已驗證的通道。 |
| D3DDDIERR_DEVICEREMOVED | 已移除圖形配接器。 |
| E_OUTOFMEMORY | 記憶體無法完成作業。 |
言論
Direct3D 運行時間會在呼叫驅動程式的 CalcPrivateAuthenticatedChannelSize 之後呼叫 CreateAuthenticatedChannel（D3D11_1），以判斷驅動程式對已驗證通道物件所需的私用數據大小。 運行時間會為驅動程式配置此私用資料的記憶體。 驅動程式會使用此記憶體來儲存與驗證通道對象相關的私人數據。
當運行時間呼叫 CreateAuthenticatedChannel（D3D11_1）時，它會將句柄傳遞至 hAuthChannel 參數中的私人數據記憶體。 這個句柄實際上是記憶體的指標。
驅動程式必須追蹤用來建立已驗證通道之顯示裝置的句柄。 如果這些呼叫中指定的顯示裝置與用來建立已驗證通道的顯示裝置不同，驅動程式應該會讓使用此已建立驗證通道的所有後續呼叫失敗，例如 NegotiateAuthenticatedChannelKeyExchange。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 支援的最低伺服器 | Windows Server 2012 |
| 目標平臺 | 桌面 |
| 標頭 | d3d10umddi.h （包括 D3d10umddi.h） |
另請參閱
CalcPrivateAuthenticatedChannelSize
CreateAuthenticatedChannel（D3D11_1）