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) |