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 para. |
| STATUS_NO_MEMORY | D3DKMTInvalidateActiveVidPn no se pudo completar debido a una memoria insuficiente. |
| STATUS_NOT_SUPPORTED | El modo de presentación solicitado por el controlador cliente instalable (ICD) de OpenGL en el búfer al que apunta el miembro pPrivateDriverData de D3DKMT_INVALIDATEACTIVEVIDPN no es compatible con el controlador de miniport 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 miniporte 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 recomendó un VidPN para reemplazar vidPN actualmente en uso. |
Esta función también puede devolver otros valores de NTSTATUS.
Observaciones
Cuando se llama a la función D3DKMTInvalidateActiveVidPn para invalidar 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 miniporte de pantalla debe ser capaz de determinar el modo de presentación que requiere openGL ICD desde el búfer al que apunta el pPrivateDriverData miembro de D3DKMT_INVALIDATEACTIVEVIDPN.
OpenGL ICD puede llamar a D3DKMTInvalidateActiveVidPn para 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows para mostrar controladores de miniport con la versión < DXGKDDI_INTERFACE_VERSION_WIN7. |
| de la plataforma de destino de | Universal |
| encabezado de | d3dkmthk.h (incluya D3dkmthk.h) |
| biblioteca de | Gdi32.lib |
| DLL de | Gdi32.dll |