Função D3DKMTInvalidateActiveVidPn (d3dkmthk.h)
A função D3DKMTInvalidateActiveVidPn invalida a VidPN (rede de vídeo presente) ativa atualmente em uso.
Nota
Essa função é obsoleta no Windows 7 e versões posteriores de sistemas operacionais Windows.
Sintaxe
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
Parâmetros
[in] unnamedParam1
Um ponteiro para uma estrutura de D3DKMT_INVALIDATEACTIVEVIDPN que descreve parâmetros que invalidam o VidPN ativo atualmente em uso.
Valor de retorno
D3DKMTInvalidateActiveVidPn retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | O VidPN atualmente em uso foi invalidado com êxito. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | Nenhum adaptador gráfico foi especificado no membro hAdapter de D3DKMT_INVALIDATEACTIVEVIDPN para o qual invalidar o VidPN. |
| STATUS_NO_MEMORY | D3DKMTInvalidateActiveVidPn não pôde ser concluída devido à memória insuficiente. |
| STATUS_NOT_SUPPORTED | O modo de exibição solicitado pelo ICD (driver de cliente) instalável do OpenGL no buffer apontado pelo membro pPrivateDriverData do D3DKMT_INVALIDATEACTIVEVIDPN não é suportado pelo driver de miniporto de exibição. Esse valor de status também será retornado se essa função for chamada em um computador que executa o Windows 7 e posterior por um driver de miniporto de exibição com DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7. |
| STATUS_DEVICE_REMOVED | O adaptador gráfico foi interrompido. |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | O driver de miniporto de exibição não recomendou um VidPN para substituir o VidPN atualmente em uso. |
Essa função também pode retornar outros valores de NTSTATUS.
Observações
Quando a função D3DKMTInvalidateActiveVidPn é chamada para invalidar o VidPN atualmente em uso, o VidPN atual é substituído por um novo VidPN recomendado pelo driver de miniporto de exibição. Como o driver de miniporto de exibição deve recomendar um novo VidPN, o driver de miniporto de exibição deve ser capaz de determinar o modo de exibição que o OpenGL ICD requer do buffer apontado pelo pPrivateDriverData membro do D3DKMT_INVALIDATEACTIVEVIDPN.
O OpenGL ICD pode chamar D3DKMTInvalidateActiveVidPn para modos de exibição (por exemplo, modo de exibição de clone) que não têm suporte usando a chamada mais geral para a função D3DKMTSetDisplayMode.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows para exibir drivers de miniporto com < DXGKDDI_INTERFACE_VERSION_WIN7 de versão. |
| da Plataforma de Destino | Universal |
| cabeçalho | d3dkmthk.h (inclua D3dkmthk.h) |
| biblioteca | Gdi32.lib |
| de DLL | Gdi32.dll |