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 に失敗する必要があります (この最後の規則の例外は初期化呼び出し自体に対するものです)。
ドライバーは、出力バッファーの構造内の入力データを複製し、出力構造に現在 Output Protection Manager (OPM) クエリを処理する方法と同じように署名する必要があります。
アプリケーションが小さすぎる出力バッファーを誤って指定する状況を除き、ドライバーは常に戻りコードを出力構造に配置する必要があります。 したがって、アプリケーションには、リターン コードを決定するためのセキュリティで保護されたメカニズムがあります。
ConfigureAuthenticatedChannel は 、入力構造で指定されている次の GUID ごとに異なる操作を実行します。 入力バッファー のサイズが、指定した GUID に対して定義されているサイズと一致しない場合、ドライバーは失敗します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | ConfigureAuthenticatedChannel は、Windows 7 オペレーティング システム以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |