Funzione DCompositionCreateSurfaceHandle (dcomp.h)

Crea un nuovo oggetto superficie di composizione che può essere associato a una catena di scambio Microsoft DirectX o a un buffer di scambio 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:

[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 concedono 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 errore DirectComposition.

Fabbisogno