Condividi tramite


Metodo ID3D11Fence::CreateSharedHandle (d3d11_3.h)

Crea un handle condiviso per un oggetto di isolamento.

Questo metodo equivale al metodo Direct3D 12 ID3D12Device::CreateSharedHandle e si applica in scenari che coinvolgono l'interoperabilità tra Direct3D 11 e Direct3D 12. In DirecX 11 è possibile aprire l'handle di isolamento condiviso con il metodo ID3D11Device5::OpenSharedFence. In DirecX 12 è possibile aprire l'handle di isolamento condiviso con il metodo ID3D12Device::OpenSharedHandle.

Sintassi

HRESULT CreateSharedHandle(
  [in, optional] const SECURITY_ATTRIBUTES *pAttributes,
                 DWORD                     dwAccess,
  [in, optional] LPCWSTR                   lpName,
  [out]          HANDLE                    *pHandle
);

Parametri

[in, optional] pAttributes

Tipo: const SECURITY_ATTRIBUTES*

Puntatore a una struttura SECURITY_ATTRIBUTES che contiene due membri dati separati ma correlati: un descrittore di sicurezza facoltativo e un valore booleano che determina se i processi figlio possono ereditare l'handle restituito.

Impostare questo parametro su NULL se si desidera che i processi figlio creati dall'applicazione non ereditino l'handle restituito da CreateSharedHandlee se si desidera che la risorsa associata all'handle restituito ottenga un descrittore di sicurezza predefinito.

Il lpSecurityDescriptor membro della struttura specifica un SECURITY_DESCRIPTOR per la risorsa. Impostare questo membro su NULL se si vuole che il runtime assegni un descrittore di sicurezza predefinito alla risorsa associata all'handle restituito. Gli elenchi di controllo di accesso nel descrittore di sicurezza predefinito per la risorsa provengono dal token primario o di rappresentazione dell'autore. Per altre informazioni, vedere Synchronization Object Security and Access Rights.

dwAccess

Tipo: DWORD

Attualmente l'unico valore accettato da questo parametro è GENERIC_ALL.

[in, optional] lpName

Tipo: LPCWSTR

Stringa dinull con terminazione NULL UNICODE contenente il nome da associare all'heap condiviso. Il nome è limitato ai caratteri MAX_PATH. Il confronto tra nomi fa distinzione tra maiuscole e minuscole.

Se Nome corrisponde al nome di una risorsa esistente, l' CreateSharedHandle ha esito negativo con DXGI_ERROR_NAME_ALREADY_EXISTS. Ciò si verifica perché questi oggetti condividono lo stesso spazio dei nomi.

Il nome può avere un prefisso "Global" o "Local" per creare in modo esplicito l'oggetto nello spazio dei nomi globale o sessione. Il resto del nome può contenere qualsiasi carattere, ad eccezione del carattere barra rovesciata (\). Per altre informazioni, vedere spazi dei nomi dell'oggetto kernel . Il passaggio rapido dell'utente viene implementato usando le sessioni di Servizi terminal. I nomi degli oggetti del kernel devono seguire le linee guida descritte per Servizi terminal in modo che le applicazioni possano supportare più utenti.

L'oggetto può essere creato in uno spazio dei nomi privato. Per altre informazioni, vedere spazi dei nomi degli oggetti .

[out] pHandle

Tipo: HANDLE*

Puntatore a una variabile che riceve il valore NT HANDLE alla risorsa da condividere. È possibile usare questo handle nelle chiamate per accedere alla risorsa.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo; in caso contrario, restituisce uno dei valori seguenti:

  • DXGI_ERROR_INVALID_CALL se uno dei parametri non è valido.
  • DXGI_ERROR_NAME_ALREADY_EXISTS se il nome specificato della risorsa da condividere è già associato a un'altra risorsa.
  • E_ACCESSDENIED se l'oggetto viene creato in uno spazio dei nomi protetto.
  • E_OUTOFMEMORY se la memoria sufficiente non è disponibile per creare l'handle.
  • Possibilmente altri codici di errore descritti nell'argomento Codici restituiti Direct3D 11.

Osservazioni

Per creare un handle condiviso per la recinzione specificata, il recinto deve essere stato creato con i flag D3D11_FENCE_FLAG_SHARED o D3D11_FENCE_FLAG_SHARED_CROSS_ADAPTER. Per altre informazioni, vedere l'enumerazione D3D11_FENCE_FLAG.

Fabbisogno

Requisito Valore
piattaforma di destinazione Finestre
intestazione d3d11_3.h
libreria D3D11.lib
dll D3D11.dll

Vedere anche

ID3D11Fence