Função VideoPortCreateSecondaryDisplay (video.h)
A função VideoPortCreateSecondaryDisplay permite o suporte de exibição dupla criando um objeto de dispositivo secundário para o dispositivo especificado.
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 de dispositivo do driver de miniport. Essa é a extensão de hardware para o dispositivo que deseja criar objetos de dispositivo de exibição adicionais.
[in, out] SecondaryDeviceExtension
Ponteiro para o local no qual armazenar a extensão de 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. |
Retornar valor
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.
Comentários
No Windows XP e posterior, um dispositivo lógico removível nunca se tornará a exibição primária.
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 minport 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, que são definidos em ntddvdeo.h, são somente para uso interno. O driver de miniporto de vídeo nunca deve definir esses sinalizadores.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows. |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | video.h (inclua Video.h) |
Biblioteca | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | PASSIVE_LEVEL |