IDisplayInformationStaticsInterop::GetForMonitor-Methode (windows.graphics.display.interop.h)

Ruft ein DisplayInformation- -Objekt für den angegebenen Monitor ab. GetForMonitor weist immer eine neue DisplayInformationzurück und gibt diese zurück.

Syntax

HRESULT GetForMonitor(
  HMONITOR monitor,
  REFIID   riid,
  void     **displayInfo
);

Parameter

monitor

Typ: [in]\ HMONITOR-

Der Ziehpunkt des Monitors.

riid

Typ: [in]\ REFIID-

Die GUID- der klasse DisplayInformation.

displayInfo

Typ: [iid_is][retval][out] void**

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf das zurückgegebene DisplayInformation-Objekt empfängt.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Bemerkungen

Betrachtungen:

• Fensterbewegungen werden nicht nachverfolgt, da kein Fenster vorhanden ist.
• Jeder vom DisplayInformation- zurückgegebene Skalierungsfaktor ist der aktuelle Skalierungsfaktor für den gesamten Monitor. Dpi-Virtualisierung fungiert auf die gleiche Weise wie für GetScaleFactorForMonitor-, die die zugrunde liegende API ist, die zum Lesen der Skalierung in diesem Fall verwendet wird.
• Wenn Sie sich für Ereignisse registrieren möchten, muss der aktuelle Thread über ein Windows.System.DispatcherQueue ausgeführt werden, um Ereignisse zu empfangen. Diese DispatcherQueue- wird beim Aufruf von GetForMonitorangedockt. Wenn keine DispatcherQueuevorhanden ist, wird in den Ereignishandlerregistrierungsmethoden eine Ausnahme (auf Der Ebene der binären Schnittstelle der Anwendung, ein HRESULT-) zurückgegeben.
• Der aktuelle Thread kann MTA oder STA sein.

Sie sind dafür verantwortlich: Zwischenspeichern der erstellten DisplayInformation-, solange das Argument Monitor relevant ist; Deregistrierung von Ereignishandlern; und löschen Sie den letzten Verweis, um die DisplayInformation Instanz zu zerstören.

Beispiele

Sehen Sie sich das Codebeispiel in IDisplayInformationStaticsInterop::GetForWindowan.

Anforderungen