Método IDisplayDeviceInterop::OpenSharedHandle (windows.devices.display.core.interop.h)

Abre um identificador para superfícies primárias compartilhadas, cercas compartilhadas e identificadores de apresentação de origem.

Sintaxe

HRESULT OpenSharedHandle(
  HANDLE NTHandle,
  IID    riid,
  void   **ppvObj
);

Parâmetros

NTHandle

Tipo: HANDLE

Um identificador NT para uma superfície primária compartilhada, cerca compartilhada ou identificador de apresentação de origem.

riid

Tipo: REFIID

Uma referência ao IID (identificador de interface) para a interface padrão de uma das seguintes classes Windows Runtime. Um IID é um GUID.

• IDisplaySurface
• IDisplayFence
• IDisplaySource

ppvObj

Tipo: void**

Um ponteiro para um bloco de memória que recebe um ponteiro para a interface especificada pelo argumento riid .

Retornar valor

Tipo: HRESULT

Retorna S_OK em caso de êxito ou um código de falha que descreve o problema em caso de falha.

Comentários

Você pode usar esse método para abrir qualquer cerca compartilhada, mas só poderá abrir uma superfície se ela tiver sido criada como primária. As superfícies primárias são superfícies destinadas a serem usadas diretamente pelo hardware de exibição para verificação. A maioria das superfícies típicas do Direct3D não são criadas como primárias, a menos que tenham sido criadas para uso em um buffer de fundo de cadeia de troca. DisplayDevice.CreatePrimary sempre cria uma superfície como primária, pois ela sempre se destina a ser usada para verificar.

Abrir um identificador de apresentação de origem é semelhante a chamar CreateScanoutSource para o destino do identificador de apresentação, exceto que não é necessário ter criado o DisplayDevice do mesmo DisplayManager que criou o identificador. Isso permite o controle de acesso refinado do scanout.

Requisitos

Confira também

• CreateSharedHandle