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 メンバーで指定されているチャネルの種類をサポートしていません。 |
備考
ランタイムは、ハンドルを必要とする後続のすべての呼び出しで、ドライバーが ChannelTypeD3DDDIARG_CREATEAUTHENTICATEDCHANNEL 構造体のメンバーで返す認証済みチャネルにハンドルを渡します。
ドライバーは、認証されたチャネルの作成に使用されたディスプレイ デバイス (hDevice) を追跡する必要があります。 これらの呼び出しで指定されたディスプレイ デバイスが、認証されたチャネルの作成に使用されたディスプレイ デバイスと異なる場合、ドライバーは、この作成された認証されたチャネル (たとえば、AuthenticatedChannelKeyExchange 関数) を使用する後続のすべての呼び出しを失敗させる必要があります。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | CreateAuthenticatedChannel は、Windows 7 オペレーティング システム以降でサポートされています。 |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | d3dumddi.h (D3dumddi.h を含む) |