/// <summary>
/// Gives a device access to a shared resource that is referenced by name and that was created on a different device. You must have previously created the resource as shared and specified that it uses NT handles (that is, you set the <see cref="ResourceOptionFlags.SharedNthandle"/> flag).
/// </summary>
/// <typeparam name="T">Type of the resource</typeparam>
/// <param name="name">Name of the resource to open for sharing.</param>
/// <param name="desiredAccess">The requested access rights to the resource.</param>
/// <returns>An instance of T.</returns>
/// <remarks>
/// The behavior of OpenSharedResourceByName is similar to the behavior of the <see cref="SharpDX.Direct3D11.Device1.OpenSharedResource1"/> method; each call to OpenSharedResourceByName to access a resource creates a new resource object. In other words, if you call OpenSharedResourceByName twice and pass the same resource name to lpName, you receive two resource objects with different <see cref="SharpDX.ComObject"/> references.To share a resource between two devicesCreate the resource as shared and specify that it uses NT handles, by setting the <see cref="SharpDX.Direct3D11.ResourceOptionFlags.SharedNthandle"/> flag. Obtain the REFIID, or <see cref="System.Guid"/>, of the interface to the resource by using the __uuidof() macro. For example, __uuidof(<see cref="SharpDX.Direct3D11.Texture2D"/>) retrieves the <see cref="System.Guid"/> of the interface to a 2D texture. Query the resource for the <see cref="SharpDX.DXGI.Resource1"/> interface. Call the <see cref="SharpDX.DXGI.Resource1.CreateSharedHandle"/> method to obtain the unique handle to the resource. In this <see cref="SharpDX.DXGI.Resource1.CreateSharedHandle"/> call, you must pass a name for the resource if you want to subsequently call OpenSharedResourceByName to access the resource by name.
/// </remarks>
/// <unmanaged>HRESULT ID3D11Device1::OpenSharedResourceByName([In] const wchar_t* lpName,[In] unsigned int dwDesiredAccess,[In] const GUID& returnedInterface,[Out] void** ppResource)</unmanaged>
public T OpenSharedResource1 <T>(string name, SharpDX.DXGI.SharedResourceFlags desiredAccess) where T : ComObject
{
IntPtr temp;
OpenSharedResourceByName(name, desiredAccess, Utilities.GetGuidFromType(typeof(T)), out temp);
return(FromPointer <T>(temp));
}
/// <summary>
/// Creates a handle to a shared resource. You can then use the returned handle with multiple Direct3D devices.
/// </summary>
/// <param name="attributesRef"><para>A reference to a <see cref="SharpDX.Win32.SecurityAttributes"/> structure that contains two separate but related data members: an optional security descriptor, and a Boolean value that determines whether child processes can inherit the returned handle.</para> <para>Set this parameter to <c>null</c> if you want child processes that the application might create to not inherit the handle returned by CreateSharedHandle, and if you want the resource that is associated with the returned handle to get a default security descriptor.</para> <para>The lpSecurityDescriptor member of the structure specifies a SECURITY_DESCRIPTOR for the resource. Set this member to <c>null</c> if you want the runtime to assign a default security descriptor to the resource that is associated with the returned handle.</para></param>
/// <param name="dwAccess"><para>The requested access rights to the resource. In addition to the generic access rights, DXGI defines the following values:</para> <see cref="SharpDX.DXGI.SharedResourceFlags.Read"/> ( 0x80000000L ) - specifies read access to the resource. <see cref="SharpDX.DXGI.SharedResourceFlags.Write"/> ( 1 ) - specifies write access to the resource. <para>You can combine these values by using a bitwise OR operation.</para></param>
/// <param name="name"><para>The name of the resource to share. You will need the resource name if you call the <see cref="SharpDX.Direct3D11.Device1.OpenSharedResourceByName"/> method to access the shared resource by name. If you instead call the <see cref="SharpDX.Direct3D11.Device1.OpenSharedResource1"/> method to access the shared resource by handle, set this parameter to <c>null</c>.</para></param>
/// <returns><para>A reference to a variable that receives the NT HANDLE value to the resource to share. You can use this handle in calls to access the resource.</para></returns>
/// <remarks>
/// If you created the resource as shared and specified that it uses NT handles (that is, you set the <see cref="SharpDX.Direct3D11.ResourceOptionFlags.SharedNthandle"/> flag), you must use CreateSharedHandle to get a handle for sharing. In this situation, you cannot use the <see cref="SharpDX.DXGI.Resource.GetSharedHandle"/> method because it will fail. Similarly, if you created the resource as shared and did not specify that it uses NT handles, you cannot use CreateSharedHandle to get a handle for sharing because CreateSharedHandle will fail.You can pass the handle that CreateSharedHandle returns in a call to the <see cref="SharpDX.Direct3D11.Device1.OpenSharedResourceByName"/> or <see cref="SharpDX.Direct3D11.Device1.OpenSharedResource1"/> method to give a device access to a shared resource that you created on a different device.CreateSharedHandle only returns the NT handle when you created the resource as shared (that is, you set the <see cref="SharpDX.Direct3D11.ResourceOptionFlags.SharedNthandle"/> and <see cref="SharpDX.Direct3D11.ResourceOptionFlags.SharedKeyedmutex"/> flags).Because the handle that CreateSharedHandle returns is an NT handle, you can use the handle with CloseHandle, DuplicateHandle, and so on. You can call CreateSharedHandle only once for a shared resource; later calls fail. If you need more handles to the same shared resource, call DuplicateHandle. When you no longer need the shared resource handle, call CloseHandle to close the handle, in order to avoid memory leaks.The creator of a shared resource must not destroy the resource until all entities that opened the resource have destroyed the resource. The validity of the handle is tied to the lifetime of the underlying video memory. If no resource objects exist on any devices that refer to this resource, the handle is no longer valid. To extend the lifetime of the handle and video memory, you must open the shared resource on a device.
/// </remarks>
/// <unmanaged>HRESULT IDXGIResource1::CreateSharedHandle([In, Optional] const SECURITY_ATTRIBUTES* pAttributes,[In] DXGI_SHARED_RESOURCE_FLAGS dwAccess,[In, Optional] const wchar_t* name,[Out] void** pHandle)</unmanaged>
public System.IntPtr CreateSharedHandle(string name, SharpDX.DXGI.SharedResourceFlags dwAccess, SharpDX.Win32.SecurityAttributes?attributesRef = null)
{
return(CreateSharedHandle(attributesRef, dwAccess, name));
}
