Funzione DCompositionCreateSurfaceHandle (dcomp.h)

Articolo
03/05/2024

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

Condividi tramite