Método IVMRMonitorConfig::GetAvailableMonitors (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O GetAvailableMonitors
método recupera informações sobre os monitores disponíveis atualmente no sistema.
Sintaxe
HRESULT GetAvailableMonitors(
[out] VMRMONITORINFO *pInfo,
[in] DWORD dwMaxInfoArraySize,
[out] DWORD *pdwNumDevices
);
Parâmetros
[out] pInfo
Ponteiro para uma matriz de estruturas VMRMONITORINFO que contêm informações sobre cada monitor no sistema.
[in] dwMaxInfoArraySize
Especifica o número máximo de membros na matriz.
[out] pdwNumDevices
Ponteiro para uma variável que recebe o número de dispositivos recuperados.
Retornar valor
Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.
Código de retorno | Descrição |
---|---|
|
Argumento inválido; dwMaxInfoArraySize deve ser maior que zero. |
|
Argumento de ponteiro NULL. |
|
Êxito. |
Comentários
Use esse método para obter uma lista de GUIDs de dispositivo DirectDraw e suas informações de monitor associadas que a VMR pode usar ao se conectar a um filtro de decodificador upstream. Para retornar o tamanho da matriz necessário no parâmetro pdwNumDevices, especifiqueNULL para pInfo.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP com SP1 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | strmif.h (inclua Dshow.h) |
Biblioteca | Strmiids.lib |