共用方式為

PFND3D11_1DDI_QUERYAUTHENTICATEDCHANNEL回呼函式 （d3d10umddi.h）

  • 發行項

查詢已驗證的通道以取得功能和狀態資訊。 由 Windows 顯示驅動程式模型 （WDDM） 1.2 或更新版本的使用者模式顯示驅動程序實作。

語法

PFND3D11_1DDI_QUERYAUTHENTICATEDCHANNEL Pfnd3d111DdiQueryauthenticatedchannel;

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

參數

hDevice

顯示裝置的句柄（圖形內容）。

hCAuthChannel

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

InputDataSize

pInputData 陣列中的數據大小，以位元組為單位。

pInputData

緩衝區的指標，描述要查詢的資訊。 此緩衝區中的數據會格式化為 D3D11_1DDI_AUTHENTICATED_QUERY_INPUT 結構。

OutputDataSize

pOutputData 陣列中的數據大小，以位元組為單位。

pOutputData

緩衝區的指標，其中包含查詢的資訊。 如需詳細資訊，請參閱一節。

傳回值

傳回下列其中一個值：

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

言論

pInputData 參數會參考包含 D3D11_1DDI_AUTHENTICATED_QUERY_INPUT 結構的緩衝區。 此結構包含已驗證通道的驅動程式句柄、序號，以及指出要執行的查詢類型 GUID。 如果之前未使用 ConfigureAuthenticatedChannel（D3D11_1） 函式初始化序號，則驅動程式必須傳回 E_INVALIDARG。 如果序號不大於先前查詢呼叫的序號，驅動程式也必須傳回 E_INVALIDARG。

pOutputData 參數所參考的位元組陣列，格式是由 D3D11_1DDI_AUTHENTICATED_QUERY_INPUT 結構的 QueryType 成員所指定。 下列清單會根據 QueryType 成員來描述此數據的格式。

驅動程式會遵循下列步驟，準備 pOutputData 參數所參考的輸出緩衝區：

  1. 根據 QueryType 成員傳回的每個結構都會以 D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT 結構開頭。 驅動程式必須將 D3D11_1DDI_AUTHENTICATED_QUERY_INPUT 的成員複製到 D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT 結構。
  2. 驅動程式必須將 ReturnCode 成員設定為會針對 QueryAuthenticatedChannel（D3D11_1） 呼叫傳回的相同傳回碼。 這會為應用程式提供存取傳回碼的安全機制。
  3. 根據 QueryType 成員的值，驅動程式必須初始化 pOutputData 緩衝區中 D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT 結構後面的對應結構。
  4. 驅動程式必須簽署 pOutputData 緩衝區，其方式與處理 Output Protection Manager （OPM） 查詢的方式相同。

    D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT 結構包含數據的 AES 型單鍵 CBC 訊息驗證碼 （OMAC）。 顯示迷你埠驅動程序必須透過輸出緩衝區中的數據計算 OMAC，才能驗證數據。 驅動程式會先將 omac 成員設定為零，然後計算緩衝區中數據的 OMAC，以執行此作業。 然後，驅動程式會將 omac 成員設定為其計算的 OMAC。

在下列情況下，顯示迷你埠驅動程式必須針對 QueryAuthenticatedChannel（D3D11_1） 呼叫傳回 E_INVALIDARG：
  • 序號不大於先前組態呼叫中指定的序號。
  • ConfigureAuthenticatedChannel（D3D11_1） 函式的呼叫尚未初始化序號。
  • OutputDataSize 參數小於 D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT 所指定的結構大小。QueryType 成員。

要求

要求 價值
最低支援的用戶端 Windows 8
支援的最低伺服器 Windows Server 2012
目標平臺 桌面
標頭 d3d10umddi.h （包括 D3d10umddi.h）

另請參閱

ConfigureAuthenticatedChannel（D3D11_1）

CreateAuthenticatedChannel（D3D11_1）

D3D11_1DDI_AUTHENTICATED_QUERY_INPUT

D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT