Função D3DKMTShareObjects (d3dkmthk.h)

Artigo
07/13/2023

D3DKMTShareObjects compartilha objetos de recurso que foram criados com as funções D3KMDTCreateAllocation, D3KMDTCreateAllocation2D3DKMTCreateKeyedMutex2 e D3DKMTCreateSynchronizationObject2 .

Sintaxe

NTSTATUS D3DKMTShareObjects(
  [in]  UINT                cObjects,
  [in]  const D3DKMT_HANDLE *hObjects,
  [in]  POBJECT_ATTRIBUTES  pObjectAttributes,
  [in]  DWORD               dwDesiredAccess,
  [out] HANDLE              *phSharedNtHandle
);

Parâmetros

[in] cObjects

O número de objetos de recurso fornecidos no parâmetro hObjects . Esse valor deve ser menor ou igual a D3DKMT_MAX_OBJECTS_PER_HANDLE.

[in] hObjects

Um ponteiro para uma matriz de identificadores locais do modo kernel que especificam os objetos de recurso a serem compartilhados. Para obter mais informações, consulte Comentários.

[in] pObjectAttributes

Um ponteiro para uma estrutura OBJECT_ATTRIBUTES que especifica atributos dos objetos de recurso.

[in] dwDesiredAccess

Especifica o acesso de leitura e gravação para o recurso.

Para objetos de sincronização de GPU, dwDesiredAccess pode ser uma combinação dos campos de bit a seguir (definidos em d3dukmdt.h).

Valor	Significado
STANDARD_RIGHTS_READ	O processo que abre o objeto de sincronização pode ler o estado do objeto de sincronização. Esse sinalizador deve ser especificado ou o objeto ficará inacessível.
D3DDDI_SYNC_OBJECT_WAIT	O processo que abre o objeto de sincronização pode emitir operações de espera para o objeto de sincronização.
D3DDDI_SYNC_OBJECT_SIGNAL	O processo que abre o objeto de sincronização pode emitir operações de sinal para o objeto de sincronização.
D3DDDI_SYNC_OBJECT_ALL_ACCESS	O processo que abre o objeto de sincronização pode emitir qualquer operação para o objeto de sincronização.

Para recursos compartilhados, o acesso desejado pode ser especificado como uma combinação dos seguintes sinalizadores (definidos em d3dkmthk.h):

Valor	Significado
STANDARD_RIGHTS_READ	O processo que abre o recurso pode ter acesso de leitura. Esse sinalizador deve ser especificado ou o objeto ficará inacessível.
SHARED_ALLOCATION_WRITE	O processo que abre o recurso pode ter acesso de gravação. Se esse sinalizador de acesso não for especificado, o recurso será aberto como somente leitura.
SHARED_ALLOCATION_ALL_ACCESS	O processo que abre o recurso pode ter todo o acesso ao objeto .

[out] phSharedNtHandle

Um ponteiro para um identificador NT compartilhado que especifica os objetos de recurso.

Esse parâmetro será NULL se o valor do sinalizador NtSecuritySharing não estiver definido. Para obter mais informações, consulte Comentários.

Retornar valor

O método retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método pode retornar um código de erro NTSTATUS apropriado.

Comentários

Os objetos a serem compartilhados usando D3DKMTShareObjects devem primeiro ser criados com o valor do sinalizador NtSecuritySharing definido. Esse valor de sinalizador está disponível nas estruturas D3DKMT_CREATEALLOCATIONFLAGS, D3DKMT_CREATEKEYEDMUTEX2_FLAGS e D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS .

Essa função deve especificar identificadores por meio do parâmetro hObjects apenas para as seguintes combinações de tipos de matriz de objeto de entrada:

uma alocação
uma alocação, um mutex com chave e um objeto de sincronização
um objeto de sincronização

O sistema operacional rejeitará qualquer outra combinação de identificador de entrada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Universal
Cabeçalho	d3dkmthk.h (inclua D3dkmthk.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll