PFND3DDDI_QUERYAUTHENTICATEDCHANNEL回呼函式 (d3dumddi.h)

  • 發行項

QueryAuthenticatedChannel 函式會查詢已驗證的通道，以取得功能和狀態資訊。

語法

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

參數

hDevice

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

unnamedParam2

pData [in， out]

描述要查詢之已驗證通道資訊 之D3DDDIARG_QUERYAUTHENTICATEDCHANNEL 結構的指標。 這個結構包含一個輸入緩衝區，描述查詢和輸出緩衝區，以傳回查詢的資訊。

傳回值

QueryAuthenticatedChannel 會傳回下列其中一個值：

傳回碼 描述
S_OK 已成功查詢已驗證的通道。
E_OUTOFMEMORY QueryAuthenticatedChannel 無法為其配置所需的記憶體以完成。

備註

輸入緩衝區包含驅動程式對已驗證通道的句柄、序號，以及指出查詢類型的 GUID。 如果驅動程式先前未透過呼叫其 ConfigureAuthenticatedChannel 函式來初始化序號，驅動程式應該會失敗所有查詢。 如果序號不大於先前查詢呼叫的序號，驅動程式也應該使查詢失敗。

驅動程式應該複製輸出緩衝區結構中的輸入數據，而且應該將輸出結構與目前處理 Output Protection Manager (OPM) 查詢的方式相同。

除了應用程式不正確地指定太小的輸出緩衝區以外，驅動程序應該一律將傳回碼放在輸出結構中。 因此，應用程式有安全的機制可判斷傳回碼。

QueryAuthenticatedChannel 會根據輸入結構中指定的每個 GUID 執行不同的作業。 如果輸入和輸出緩衝區大小不符合為指定 GUID 定義的大小，驅動程式應該會失敗。

規格需求

需求 值
最低支援的用戶端 從 Windows 7 操作系統開始，支援 QueryAuthenticatedChannel。
目標平台 桌面
標頭 d3dumddi.h (包含 D3dumddi.h)

另請參閱

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL