PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL回呼函式 (d3d10umddi.h)

發行項
02/22/2024

建立已驗證的通道物件。由 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。