Método IDXGIResource::GetSharedHandle (dxgi.h)

[A partir de Direct3D 11.1, se recomienda no usar GetSharedHandle para recuperar el identificador de un recurso compartido. En su lugar, use IDXGIResource1::CreateSharedHandle para obtener un identificador para compartir. Para usar IDXGIResource1::CreateSharedHandle, debe crear el recurso como compartido y especificar que usa identificadores NT (es decir, establezca la marca D3D11_RESOURCE_MISC_SHARED_NTHANDLE ). También se recomienda crear recursos compartidos que usen identificadores NT para que pueda usar CloseHandle, DuplicateHandle, etc. en esos recursos compartidos.

Obtiene el identificador de un recurso compartido.

Sintaxis

HRESULT GetSharedHandle(
  [out] HANDLE *pSharedHandle
);

Parámetros

[out] pSharedHandle

Tipo: HANDLE*

Puntero a un identificador.

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores de DXGI_ERROR .

Comentarios

GetSharedHandle devuelve un identificador para el recurso que creó como compartido (es decir, establece el D3D11_RESOURCE_MISC_SHARED con o sin la marca D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX ). Puede pasar este identificador al método ID3D11Device::OpenSharedResource para conceder a otro dispositivo acceso al recurso compartido. También puede serializar este identificador a otro proceso para compartir un recurso con un dispositivo en otro proceso. Sin embargo, este identificador no es un identificador NT. Por lo tanto, no use el identificador con CloseHandle, DuplicateHandle, etc.

El creador de un recurso compartido no debe destruir el recurso hasta que todas las entidades deseadas hayan abierto el recurso. La validez del identificador está asociada a la duración de la memoria de vídeo subyacente. Si no existen objetos de recursos en ningún dispositivo que haga referencia a este recurso, el identificador ya no es válido. Para ampliar la duración del identificador y la memoria de vídeo, debe abrir el recurso compartido en un dispositivo.

GetSharedHandle también puede devolver identificadores de los recursos que se pasaron a ID3D11Device::OpenSharedResource para abrir esos recursos.

GetSharedHandle produce un error si el recurso al que quiere obtener un identificador no se comparte.

Requisitos

Consulte también

IDXGIResource