Condividi tramite

Funzione DCompositionCreateSurfaceHandle (dcomp.h)

  • Articolo

Crea un nuovo oggetto superficie di composizione che può essere associato a una catena di scambio Microsoft DirectX o scambia buffer e associato a un oggetto visivo.

Sintassi

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

Parametri

[in] desiredAccess

Tipo: DWORD

Accesso richiesto all'oggetto superficie di composizione. Può essere uno dei valori seguenti:

Valore Significato
0x0000L
 Nessun accesso.
COMPOSITIONSURFACE_READ
0x0001L
 Accesso in lettura. Solo per uso interno.
COMPOSITIONSURFACE_WRITE
0x0002L
 Accesso in scrittura. Solo per uso interno.
COMPOSITIONSURFACE_ALL_ACCESS
0x0003L
 Accesso in lettura/scrittura. Specificare sempre questo flag, tranne quando si duplica una superficie in un altro processo, nel qual caso impostare desiredAccess su 0.

[in, optional] securityAttributes

Tipo: SECURITY_ATTRIBUTES*

Contiene il descrittore di sicurezza per l'oggetto superficie di composizione e specifica se l'handle dell'oggetto superficie di composizione è ereditabile quando viene creato un processo figlio. Se questo parametro è NULL, l'oggetto superficie di composizione viene creato con attributi di sicurezza predefiniti che consentono l'accesso in lettura e scrittura al processo corrente, ma non consentono ai processi figlio di ereditare l'handle.

[out] surfaceHandle

Tipo: HANDLE*

Handle del nuovo oggetto superficie di composizione. Questo parametro non deve essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dcomp.h
Libreria Dcomp.lib
DLL Dcomp.dll