Condividi tramite

Metodo IDisplayDeviceInterop::OpenSharedHandle (windows.devices.display.core.interop.h)

  • Articolo

Apre un handle per superfici primarie condivise, recinzioni condivise e handle di presentazione di origine.

Sintassi

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

Parametri

NTHandle

Tipo: HANDLE

Handle NT per una superficie primaria condivisa, un recinto condiviso o un handle di presentazione di origine.

riid

Tipo: REFIID

Riferimento all'identificatore dell'interfaccia (IID) per l'interfaccia predefinita di una delle classi di Windows Runtime seguenti. Un IID è un GUID.

ppvObj

Tipo: void**

Puntatore a un blocco di memoria che riceve un puntatore all'interfaccia specificata dall'argomento riid .

Valore restituito

Tipo: HRESULT

Restituisce S_OK sull'esito positivo o su un codice di errore che descrive il problema in caso di errore.

Commenti

È possibile usare questo metodo per aprire qualsiasi recinzione condivisa, ma è possibile aprire una superficie solo se è stata creata come primaria. Le superfici primarie sono superfici destinate a essere usate direttamente dall'hardware di visualizzazione per l'analisi. La maggior parte delle superfici Direct3D tipiche non viene creata come primarie a meno che non siano state create per l'uso in un buffer back della catena di scambio. DisplayDevice.CreatePrimary crea sempre una superficie come primaria, poiché è sempre destinata a essere usata per l'analisi.

L'apertura di un handle di presentazione di origine è simile alla chiamata di CreateScanoutSource per la destinazione dell'handle di presentazione, ad eccezione del fatto che non è necessario creare DisplayDevice dallo stesso DisplayManager che ha creato l'handle. In questo modo è possibile controllare l'accesso con granularità fine dell'analisi.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Piattaforma di destinazione Windows
Intestazione windows.devices.display.core.interop.h
Libreria d3d12.lib
DLL d3d12.dll

Vedi anche