PFND3DDDI_CREATEAUTHENTICATEDCHANNEL コールバック関数 (d3dumddi.h)
CreateAuthenticatedChannel 関数は、Microsoft Direct3D ランタイムとドライバーが保護の設定とクエリに使用できるチャネルを作成します。
構文
PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;
HRESULT Pfnd3dddiCreateauthenticatedchannel(
HANDLE hDevice,
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
パラメーター
hDevice
ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。
unnamedParam2
pData [in, out]
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL構造体へのポインター。 入力時に、この構造体にはドライバーが使用できる情報が含まれます。 出力時に、ドライバーは Direct3D ランタイムが使用できる構造体の情報を指定します。
戻り値
CreateAuthenticatedChannel は 、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
S_OK | チャネルが正常に作成されました。 |
E_OUTOFMEMORY | CreateAuthenticatedChannel は、完了するために必要なメモリを割り当てませんでした。 |
D3DDDIERR_NOTAVAILABLE | ドライバーは、pData パラメーターが指す D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 構造体の ChannelType メンバーで指定されているチャネルの種類をサポートしていません。 |
注釈
ランタイムは、ハンドルを必要とする後続のすべての呼び出しで、ドライバーがD3DDDIARG_CREATEAUTHENTICATEDCHANNEL構造体の ChannelType メンバーで返す認証済みチャネルにハンドルを渡します。
ドライバーは、認証されたチャネルの作成に使用されたディスプレイ デバイス (hDevice) を追跡する必要があります。 これらの呼び出しで指定されたディスプレイ デバイスが、認証されたチャネルの作成に使用されたディスプレイ デバイスと異なる場合、ドライバーは、この作成された認証済みチャネル ( AuthenticatedChannelKeyExchange 関数など) を使用する後続のすべての呼び出しに失敗する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | CreateAuthenticatedChannel は、Windows 7 オペレーティング システム以降でサポートされています。 |
対象プラットフォーム | デスクトップ |
Header | d3dumddi.h (D3dumddi.h を含む) |