次の方法で共有

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 関数の呼び出しによってシーケンス番号を初期化しなかった場合、ドライバーはすべてのクエリを失敗させる必要があります。 また、シーケンス番号が前のクエリ呼び出しのシーケンス番号を超えない場合、ドライバーはクエリを失敗させる必要があります。

ドライバーは、出力バッファーの構造内の入力データを複製する必要があり、出力構造に現在、出力保護マネージャー (OPM) クエリ 処理する方法と同じように署名する必要があります。

アプリケーションが小さすぎる出力バッファーを誤って指定する状況を除き、ドライバーは常に戻りコードを出力構造に配置する必要があります。 そのため、アプリケーションには、リターン コードを決定するためのセキュリティで保護されたメカニズムがあります。

QueryAuthenticatedChannel は、入力構造で指定されている次の GUID ごとに異なる操作を実行します。 入力バッファーと出力バッファーのサイズが、指定した GUID に定義されているサイズと一致しない場合、ドライバーは失敗します。

必要条件

要件 価値
サポートされる最小クライアント QueryAuthenticatedChannel は、Windows 7 オペレーティング システム以降でサポートされています。
ターゲット プラットフォーム の デスクトップ
ヘッダー d3dumddi.h (D3dumddi.h を含む)

関連項目

ConfigureAuthenticatedChannel の

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL