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 參數所參考的輸出緩衝區:
- 根據 QueryType 成員傳回的每個結構都會以 D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT 結構開頭。 驅動程式必須將 D3D11_1DDI_AUTHENTICATED_QUERY_INPUT 的成員複製到 D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT 結構。
- 驅動程式必須將 ReturnCode 成員設定為它針對 QueryAuthenticatedChannel (D3D11_1) 呼叫所傳回的相同傳回碼。 這會為應用程式提供存取傳回碼的安全機制。
- 根據 QueryType 成員的值,驅動程式必須初始化 pOutputData 緩衝區中D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT結構後面的對應結構。
-
驅動程式必須以與處理 Output Protection Manager (OPM) 查詢的方式相同的方式來簽署 pOutputData 緩衝區。
D3D11_1DDI_AUTHENTICATED_QUERY_OUTPUT 結構包含 AES 型單鍵 CBC 訊息驗證碼, (OMAC) 數據。 顯示迷你埠驅動程序必須透過輸出緩衝區中的數據計算 OMAC,才能驗證數據。 驅動程式會先將 omac 成員設定為零,然後計算緩衝區中數據的 OMAC 來執行此動作。 驅動程式接著會將 omac 成員設定為其計算的 OMAC。
- 序號不大於先前組態呼叫中指定的序號。
- 對 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)