Função VideoPortCreateSecondaryDisplay (video.h)

Artigo
02/07/2025

A função VideoPortCreateSecondaryDisplay permite o suporte de exibição dupla criando um objeto de dispositivo secundário para o dispositivo fornecido.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCreateSecondaryDisplay(
  [in]      IN PVOID     HwDeviceExtension,
  [in, out] IN OUT PVOID *SecondaryDeviceExtension,
  [in]      IN ULONG     ulFlag
);

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão do dispositivo do driver de miniport. Essa é a extensão de hardware do dispositivo que deseja criar objetos de dispositivo de exibição adicionais.

[in, out] SecondaryDeviceExtension

Ponteiro para o local no qual armazenar a extensão do dispositivo de hardware para o dispositivo de exibição secundário.

[in] ulFlag

É um conjunto de atributos para o dispositivo de exibição secundário. Esse parâmetro é restrito ao seguinte valor:

Valor	Significado
VIDEO_DUALVIEW_REMOVABLE	A exibição secundária pode ser removida.

Valor de retorno

VideoPortCreateSecondaryDisplay retornará NO_ERROR se o dispositivo de exibição secundário tiver sido criado com êxito. Caso contrário, essa função retornará um código de erro.

Observações

No Windows XP e posterior, um dispositivo lógico removível nunca se tornará o de exibição principal.

Observe que, em algumas edições do Windows XP, VideoPortCreateSecondaryDisplay pode falhar deliberadamente ao habilitar o Dualview. Nesses casos, o driver de exibição deve permanecer no modo SingleView.

Quando o driver de miniporto de vídeo chama VideoPortCreateSecondaryDisplay, o valor do parâmetro ulFlags deve ser igual a VIDEO_DUALVIEW_REMOVABLE, que é definido em ntddvdeo.h.

Os sinalizadores VIDEO_DUALVIEW_PRIMARY e VIDEO_DUALVIEW_SECONDARY, definidos em ntddvdeo.h, são apenas para uso interno. O driver do miniporto de vídeo nunca deve definir esses sinalizadores.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	video.h (inclua Video.h)
biblioteca	Videoprt.lib
de DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Compartilhar via