次の方法で共有

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL コールバック関数 (d3dumddi.h)

  • [アーティクル]

ConfigureAuthenticatedChannel 関数は、認証されたチャネル内の状態を設定します。

構文

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

パラメーター

hDevice

ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。

unnamedParam2

pData [in, out]

認証されたチャネルを構成する方法を説明する D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL 構造体へのポインター。 この構造体には、認証されたチャネルを構成する方法を説明する入力バッファーと、構成情報を含む出力バッファーが含まれています。

戻り値

ConfigureAuthenticatedChannel は、次のいずれかの値を返します。

リターン コード 説明
S_OK 認証されたチャネルが正常に構成されました。
E_OUTOFMEMORY ConfigureAuthenticatedChannel 、完了するために必要なメモリを割り当てませんでした。

備考

入力バッファーには、ドライバーが認証する必要がある 1 キー暗号ブロック チェーン (CBC) モード メッセージ認証コード (OMAC) が含まれています。 入力バッファーには、認証されたチャネルに対するドライバーのハンドル、シーケンス番号、および構成の種類を示す GUID も含まれます。

ドライバーは、入力 OMAC が一致しない場合、シーケンス番号が前回の呼び出しで指定されたシーケンス番号より大きくない場合、またはシーケンス番号がまだ初期化されていない場合 (この最後のルールの例外は初期化呼び出し自体の例外) の場合、ConfigureAuthenticatedChannel 失敗する必要があります。

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

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

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

必要条件

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

関連項目

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL