IVMRMonitorConfig::GetAvailableMonitors-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die GetAvailableMonitors -Methode ruft Informationen zu den derzeit im System verfügbaren Monitoren ab.
Syntax
HRESULT GetAvailableMonitors(
[out] VMRMONITORINFO *pInfo,
[in] DWORD dwMaxInfoArraySize,
[out] DWORD *pdwNumDevices
);
Parameter
[out] pInfo
Zeiger auf ein Array von VMRMONITORINFO-Strukturen , die Informationen zu den einzelnen Monitoren auf dem System enthalten.
[in] dwMaxInfoArraySize
Gibt die maximale Anzahl von Membern im Array an.
[out] pdwNumDevices
Zeiger auf eine Variable, die die Anzahl der abgerufenen Geräte empfängt.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | Beschreibung |
|---|---|
|
Ungültiges Argument; dwMaxInfoArraySize muss größer als 0 (null) sein. |
|
NULL-Zeigerargument. |
|
Erfolg. |
Hinweise
Verwenden Sie diese Methode, um eine Liste der DirectDraw-Geräte-GUIDs und der zugehörigen Überwachungsinformationen abzurufen, die die VMR beim Herstellen einer Verbindung mit einem Upstream Decoderfilter verwenden kann. Geben Sie null für pInfo an, um die erforderliche Arraygröße im pdwNumDevices-Parameter zurückzugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |