Partilhar via


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