PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL回呼函式 (d3d10umddi.h)

  • 發行項

處理來自應用程式的要求，以設定已驗證的通道以進行內容保護。 由 Windows 顯示驅動程式模型 (WDDM) 1.2 或更新版本的使用者模式顯示驅動程式實作。

語法

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;

HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT InputDataSize,
  const VOID *pInputData,
  D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}

參數

hDevice

顯示裝置的句柄 (圖形內容) 。

hCAuthChannel

透過呼叫 CreateAuthenticatedChannel (D3D11_1) 函式所建立之已驗證通道物件的句柄。

InputDataSize

pInputData 參數所指定的數位大小，以位元組為單位。

pInputData

位元組陣列的指標，其中包含命令的輸入數據。 如需詳細資訊，請參閱＜備註＞一節。

pOutputData

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT 結構的指標。 如需詳細資訊，請參閱＜備註＞一節。

傳回值

傳回下列其中一值：

傳回碼 描述
S_OK 已成功設定已驗證的通道。
E_FAIL 顯示迷你埠驅動程序不支援指定的命令
E_INVALIDARG 已驗證參數，並判斷為不正確。
E_OUTOFMEMORY 記憶體無法完成作業。

備註

pInputData 參數所參考的位元組陣列會以下列方式格式化：

下列清單會根據 ConfigureType 成員描述此數據的格式。

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT 結構包含 AES 型單鍵 CBC 訊息驗證程式代碼， (OMAC) 資料。 顯示迷你埠驅動程序必須透過數據計算自己的 OMAC，才能驗證數據。 此輸入結構也包含已驗證通道的驅動程式句柄、序號，以及指出組態類型的 GUID。

當顯示迷你連接埠驅動程式初始化 D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT 結構時，會遵循下列步驟：

  1. 驅動程式必須將輸入數據複製到 D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT 結構。

  2. 驅動程式必須將 ReturnCode 成員設定為將針對 ConfigureAuthenticatedChannel (D3D11_1) 呼叫傳回的相同傳回碼。 這提供應用程式存取傳回碼的安全機制。

  3. 驅動程式會將 omac 成員設定為零，然後計算 結構中數據的 OMAC。 然後，驅動程式會將 omac 成員設定為其計算的 OMAC

在下列情況下，顯示迷你埠驅動程序必須針對 ConfigureAuthenticatedChannel 呼叫傳回E_INVALIDARG：

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT 結構的 omac 成員與驅動程式計算的 OMAC 不符。

  • 序號不大於先前組態呼叫中指定的序號。

  • 對 ConfigureAuthenticatedChannel (D3D11_1) 函式的呼叫尚未初始化序號。

  • InputDataSize 參數小於 D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT 結構的大小加上D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT所指定的結構大小。ConfigureTypemember。

規格需求

需求 值
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
目標平台 桌面
標頭 d3d10umddi.h (include D3d10umddi.h)

另請參閱

CreateAuthenticatedChannel (D3D11_1)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT