Función D3DKMTInvalidateActiveVidPn (d3dkmthk.h)
La función D3DKMTInvalidateActiveVidPn invalida la red activa de vídeo presente (VidPN) actualmente en uso.
Nota
Esta función está obsoleta en Windows 7 y versiones posteriores de los sistemas operativos Windows.
Sintaxis
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
Parámetros
[in] unnamedParam1
Puntero a una estructura de D3DKMT_INVALIDATEACTIVEVIDPN que describe los parámetros que invalidan el VidPN activo actualmente en uso.
Valor devuelto
D3DKMTInvalidateActiveVidPn devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | El VidPN actualmente en uso se invalidó correctamente. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | No se especificó ningún adaptador de gráficos en el miembro hAdapter de D3DKMT_INVALIDATEACTIVEVIDPN para invalidar vidPN. |
| STATUS_NO_MEMORY | D3DKMTInvalidateActiveVidPn no se pudo completar debido a una memoria insuficiente. |
| STATUS_NOT_SUPPORTED | El controlador de cliente instalable (ICD) de OpenGL solicitado por el controlador de cliente instalable de OpenGL en el búfer al que apunta el miembro pPrivateDriverData de D3DKMT_INVALIDATEACTIVEVIDPN no es compatible con el controlador de miniporte de pantalla. Este valor de estado también se devolverá si se llama a esta función en un equipo que ejecuta Windows 7 y versiones posteriores mediante un controlador de minipuerto de pantalla con DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7. |
| STATUS_DEVICE_REMOVED | El adaptador de gráficos se detuvo. |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | El controlador de minipuerto de pantalla no recomendaba un VidPN para reemplazar vidPN actualmente en uso. |
Esta función también podría devolver otros valores NTSTATUS .
Comentarios
Cuando se llama a la función D3DKMTInvalidateActiveVidPn para invalidar el VidPN actualmente en uso, el VidPN actual se reemplaza por un nuevo VidPN que recomienda el controlador de miniporte de pantalla. Dado que el controlador de minipuerto de pantalla debe recomendar un nuevo VidPN, el controlador de minipuerto de pantalla debe ser capaz de determinar el modo de presentación que requiere OpenGL ICD desde el búfer al que apunta el miembro pPrivateDriverData de D3DKMT_INVALIDATEACTIVEVIDPN.
OpenGL ICD puede llamar a D3DKMTInvalidateActiveVidPn para los modos de visualización (por ejemplo, modo de vista clonada) que no se admiten mediante la llamada más general a la función D3DKMTSetDisplayMode .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows para mostrar controladores de minipuerto con la versión < DXGKDDI_INTERFACE_VERSION_WIN7. |
| Plataforma de destino | Universal |
| Encabezado | d3dkmthk.h (incluya D3dkmthk.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |