Funzione D3DKMTInvalidateActiveVidPn (d3dkmthk.h)
La funzione D3DKMTInvalidateActiveVidPn invalida attualmente in uso la rete attiva presente nel video (VidPN).
Nota
Questa funzione è obsoleta in Windows 7 e versioni successive dei sistemi operativi Windows.
Sintassi
NTSTATUS D3DKMTInvalidateActiveVidPn(
[in] const D3DKMT_INVALIDATEACTIVEVIDPN *unnamedParam1
);
Parametri
[in] unnamedParam1
Puntatore a una struttura D3DKMT_INVALIDATEACTIVEVIDPN che descrive i parametri che invalidano il VidPN attivo attualmente in uso.
Valore restituito
D3DKMTInvalidateActiveVidPn restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Il VidPN attualmente in uso è stato invalidato correttamente. |
| STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER | Nessuna scheda grafica specificata nel membro hAdapter di D3DKMT_INVALIDATEACTIVEVIDPN per invalidare il VidPN per. |
| STATUS_NO_MEMORY | Impossibile completare D3DKMTInvalidateActiveVidPn a causa di memoria insufficiente. |
| STATUS_NOT_SUPPORTED | La modalità di visualizzazione richiesta dal driver client installabile OpenGL nel buffer a cui punta il membro pPrivateDriverData di D3DKMT_INVALIDATEACTIVEVIDPN non è supportata dal driver miniport di visualizzazione. Questo valore di stato verrà restituito anche se questa funzione viene chiamata in un computer che esegue Windows 7 e versioni successive da un driver miniport visualizzato con DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7. |
| STATUS_DEVICE_REMOVED | La scheda grafica è stata arrestata. |
| STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN | Il driver miniport di visualizzazione non ha consigliato un VidPN per sostituire il VidPN attualmente in uso. |
Questa funzione potrebbe anche restituire altri valori NTSTATUS .
Commenti
Quando viene chiamata la funzione D3DKMTInvalidateActiveVidPn per invalidare il VidPN attualmente in uso, il VidPN corrente viene sostituito con un nuovo VidPN consigliato dal driver miniport di visualizzazione. Poiché il driver miniport di visualizzazione deve consigliare un nuovo VidPN, il driver miniport di visualizzazione deve essere in grado di determinare la modalità di visualizzazione richiesta da OpenGL ICD dal buffer a cui punta il membro pPrivateDriverData di D3DKMT_INVALIDATEACTIVEVIDPN.
OpenGL ICD può chiamare D3DKMTInvalidateActiveVidPn per le modalità di visualizzazione (ad esempio, la modalità di visualizzazione clone) non supportate tramite la chiamata più generale alla funzione D3DKMTSetDisplayMode .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows per visualizzare i driver miniport con versione < DXGKDDI_INTERFACE_VERSION_WIN7. |
| Piattaforma di destinazione | Universale |
| Intestazione | d3dkmthk.h (include D3dkmthk.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |