Método ID3D12Device::CreateSharedHandle (d3d12.h)
Crea un identificador compartido en un montón, un recurso o un objeto de barrera.
Sintaxis
HRESULT CreateSharedHandle(
[in] ID3D12DeviceChild *pObject,
[in, optional] const SECURITY_ATTRIBUTES *pAttributes,
DWORD Access,
[in, optional] LPCWSTR Name,
[out] HANDLE *pHandle
);
Parámetros
[in] pObject
Tipo: ID3D12DeviceChild*
Puntero a la interfaz ID3D12DeviceChild que representa el montón, el recurso o el objeto de barrera que se va a crear para el uso compartido. Se admiten las siguientes interfaces (derivadas de ID3D12DeviceChild):
[in, optional] pAttributes
Tipo: const SECURITY_ATTRIBUTES*
Puntero a una estructura de SECURITY_ATTRIBUTES que contiene dos miembros de datos independientes pero relacionados: un descriptor de seguridad opcional y un valor booleano que determina si los procesos secundarios pueden heredar el identificador devuelto.
Establezca este parámetro en NULL si desea que los procesos secundarios que la aplicación cree no hereden el identificador devuelto por CreateSharedHandle y, si desea que el recurso asociado al identificador devuelto obtenga un descriptor de seguridad predeterminado.
El miembro lpSecurityDescriptor de la estructura especifica un SECURITY_DESCRIPTOR para el recurso. Establezca este miembro en NULL si desea que el tiempo de ejecución asigne un descriptor de seguridad predeterminado al recurso asociado al identificador devuelto. Las ACL del descriptor de seguridad predeterminado para el recurso proceden del token principal o de suplantación del creador. Para obtener más información, consulta Derechos de acceso y seguridad de objetos de sincronización.
Access
Tipo: DWORD
Actualmente, el único valor que acepta este parámetro es GENERIC_ALL.
[in, optional] Name
Tipo: LPCWSTR
Cadena UNICODE terminada en NULL que contiene el nombre que se va a asociar al montón compartido. El nombre se limita a MAX_PATH caracteres. La comparación de nombres distingue mayúsculas de minúsculas.
Si Name coincide con el nombre de un recurso existente, CreateSharedHandle produce un error con DXGI_ERROR_NAME_ALREADY_EXISTS. Esto ocurre porque estos objetos comparten el mismo espacio de nombres.
El nombre puede tener un prefijo "Global" o "Local" para crear explícitamente el objeto en el espacio de nombres global o de sesión. El resto del nombre puede contener cualquier carácter excepto el carácter de barra diagonal inversa (\). Para obtener más información, vea Espacios de nombres de objeto kernel. El cambio rápido de usuarios se implementa mediante sesiones de Terminal Services. Los nombres de objeto de kernel deben seguir las directrices descritas para Terminal Services para que las aplicaciones puedan admitir varios usuarios.
El objeto se puede crear en un espacio de nombres privado. Para obtener más información, vea Espacios de nombres de objeto.
[out] pHandle
Tipo: HANDLE*
Puntero a una variable que recibe el valor NT HANDLE al recurso que se va a compartir. Puede usar este identificador en las llamadas para acceder al recurso.
Valor devuelto
Tipo: HRESULT
Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve uno de los valores siguientes:
- DXGI_ERROR_INVALID_CALL si uno de los parámetros no es válido.
- DXGI_ERROR_NAME_ALREADY_EXISTS si el nombre proporcionado del recurso compartido ya está asociado a otro recurso.
- E_ACCESSDENIED si el objeto se crea en un espacio de nombres protegido.
- E_OUTOFMEMORY si no hay suficiente memoria disponible para crear el identificador.
- Posiblemente otros códigos de error que se describen en el tema Códigos de retorno de Direct3D 12 .
Comentarios
Se pueden compartir tanto montones como recursos confirmados. Compartir un recurso confirmado comparte el montón implícito junto con la descripción del recurso confirmado, de modo que se pueda asignar una descripción de recursos compatible al montón desde otro dispositivo.
Para escenarios de interoperabilidad de Direct3D 11 y Direct3D 12, se abre una barrera compartida en DirectX 11 con el método ID3D11Device5::OpenSharedFence y se abre un recurso compartido con el método ID3D11Device::OpenSharedResource1 .
Para Direct3D 12, se abre un identificador compartido con el método ID3D12Device::OpenSharedHandle o id3D12Device::OpenSharedHandleByName.
Requisitos
Plataforma de destino | Windows |
Encabezado | d3d12.h |
Library | D3D12.lib |
Archivo DLL | D3D12.dll |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de