次の方法で共有


DCompositionCreateSurfaceHandle 関数 (dcomp.h)

Microsoft DirectX スワップ チェーンまたはスワップ バッファーにバインドし、ビジュアルに関連付けることができる新しいコンポジション サーフェス オブジェクトを作成します。

構文

HRESULT DCompositionCreateSurfaceHandle(
  [in]           DWORD               desiredAccess,
  [in, optional] SECURITY_ATTRIBUTES *securityAttributes,
  [out]          HANDLE              *surfaceHandle
);

パラメーター

[in] desiredAccess

種類: DWORD

コンポジション サーフェス オブジェクトへの要求されたアクセス。 次のいずれかの値を指定できます。

意味
0x0000L
アクセスできません。
COMPOSITIONSURFACE_READ
0x0001L
読み取りアクセス。 内部使用専用です。
COMPOSITIONSURFACE_WRITE
0x0002L
書き込みアクセス。 内部使用専用です。
COMPOSITIONSURFACE_ALL_ACCESS
0x0003L
読み取り/書き込みアクセス。 別のプロセスでサーフェスを複製する場合を除き、常にこのフラグを指定します。この場合は desiredAccess を 0 に設定します。

[in, optional] securityAttributes

種類: SECURITY_ATTRIBUTES*

コンポジション サーフェス オブジェクトのセキュリティ記述子を格納し、子プロセスの作成時にコンポジション サーフェス オブジェクトのハンドルを継承できるかどうかを指定します。 このパラメーターが NULL の場合、コンポジション サーフェス オブジェクトは、現在のプロセスへの読み取りおよび書き込みアクセスを許可する既定のセキュリティ属性を使用して作成されますが、子プロセスでハンドルを継承することはできません。

[out] surfaceHandle

型: HANDLE*

新しいコンポジション サーフェス オブジェクトのハンドル。 このパラメーターを NULL にすることはできません。

戻り値

種類: HRESULT

関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー dcomp.h
Library Dcomp.lib
[DLL] Dcomp.dll