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 に対して定義されているサイズと一致しない場合、ドライバーは失敗します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | QueryAuthenticatedChannel は、Windows 7 オペレーティング システム以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |