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

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.

• IDisplaySurface
• IDisplayFence
• IDisplaySource

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

Vedi anche

• CreateSharedHandle