Função D3DKMTInvalidateActiveVidPn (d3dkmthk.h)
A função D3DKMTInvalidateActiveVidPn invalida a VidPN (rede de vídeo presente) ativa atualmente em uso.
Observação
Essa função está obsoleta no Windows 7 e em versões posteriores dos sistemas operacionais Windows.
Sintaxe
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
Parâmetros
[in] unnamedParam1
Um ponteiro para uma estrutura D3DKMT_INVALIDATEACTIVEVIDPN que descreve parâmetros que invalidam o VidPN ativo atualmente em uso.
Retornar valor
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 do D3DKMT_INVALIDATEACTIVEVIDPN para o qual invalidar o VidPN. |
| STATUS_NO_MEMORY | D3DKMTInvalidateActiveVidPn não pôde ser concluído devido à memória insuficiente. |
| STATUS_NOT_SUPPORTED | O modo de exibição solicitado pelo ICD (driver de cliente instalável) 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 miniporta 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 NTSTATUS .
Comentários
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 miniporta de vídeo 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 membro pPrivateDriverData 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 |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows para exibir drivers de miniporta com DXGKDDI_INTERFACE_VERSION_WIN7 de versão < . |
| Plataforma de Destino | Universal |
| Cabeçalho | d3dkmthk.h (inclua D3dkmthk.h) |
| Biblioteca | Gdi32.lib |
| DLL | Gdi32.dll |