_fpieee_flt
Richiama un gestore delle trap definito dall'utente per le eccezioni a virgola mobile IEEE.
int _fpieee_flt(
unsigned long excCode,
struct _EXCEPTION_POINTERS *excInfo,
int handler(_FPIEEE_RECORD *)
);
Parametri
excCode
Codice dell'eccezione.excInfo
Puntatore ad una struttura di informazioni sulle eccezioni di Windows NT.handler
Puntatore alla routine del gestore delle trap IEEE dell'utente.
Valore restituito
Il valore di ritorno di _fpieee_flt è il valore restituito da handler. Come tale, la routine di filtro IEEE può essere utilizzata nella clausola di eccezione di un meccanismo strutturato per la gestione delle eccezioni (SEH, Structured Exception-Handling).
Note
La funzione _fpieee_flt invoca un gestore di trap definito dall'utente per le eccezioni a virgola mobile IEEE e gli fornisce tutte le informazioni rilevanti. Questa routine svolge la funzione di filtro eccezioni nel meccanismo SEH, il quale invoca il gestore delle eccezioni personale quando necessario.
La struttura _FPIEEE_RECORD, definita in Fpieee.h, contiene informazioni relative ad un'eccezione a virgola mobile IEEE. Questa struttura viene passata al gestore di trap definito dall'utente da _fpieee_flt.
Campo _FPIEEE_RECORD |
Descrizione |
|---|---|
unsigned int RoundingMode, unsigned int Precision |
Questi campi contengono informazioni sull'ambiente a virgola mobile al momento in cui si è verificata l'eccezione. |
unsigned int Operation |
Indica il tipo di operazione che ha causato la trap. Se il tipo è un confronto (_FpCodeCompare), è possibile specificare uno dei valori speciali _FPIEEE_COMPARE_RESULT (come definito in Fpieee.h) nel campo Result.Value. Il tipo di conversione (_FpCodeConvert) indica che la trap si è verificata durante un'operazione di conversione a virgola mobile. È possibile osservare i tipi Operand1 e Result per determinare il tipo di conversione che viene tentata. |
_FPIEEE_VALUE Operand1, _FPIEEE_VALUE Operand2, _FPIEEE_VALUE Result |
Queste strutture indicano i tipi ed i valori del risultato e degli operandi proposti: OperandValid Flag che indica se il valore di risposta è valido. Format Tipo di dati del valore corrispondente. Il tipo di formato potrebbe essere restituito anche se il valore corrispondente non è valido. Value Risultato o valore dei dati dell'operando. |
_FPIEEE_EXCEPTION_FLAGS Cause, _FPIEEE_EXCEPTION_FLAGS Enable, _FPIEEE_EXCEPTION_FLAGS Status |
_FPIEEE_EXCEPTION_FLAGS contiene un campo di bit per ciascun tipo di eccezione a virgola mobile. Esiste una corrispondenza tra questi campi e gli argomenti utilizzati per mascherare le eccezioni fornite a _controlfp. Il significato esatto di ogni bit dipende dal contesto: Cause Ogni set di bit indica la particolare eccezione generata. Enable Ogni set di bit indica che l'eccezione specifica è attualmente smascherata. Status Ogni set di bit indica che l'eccezione specifica è attualmente in sospeso. Questo include le eccezioni che non sono state generate in quanto sono state mascherate da _controlfp. |
Le eccezioni in sospeso disabilitate vengono generate quando esse vengono abilitate. Questo può determinare un comportamento indefinito durante l'utilizzo di _fpieee_flt come filtro eccezioni. Chiamare sempre _clearfp prima di abilitare le eccezioni a virgola mobile.
Requisiti
Funzione |
Intestazione obbligatoria |
|---|---|
_fpieee_flt |
<fpieee.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Esempio
// crt_fpieee.c
// This program demonstrates the implementation of
// a user-defined floating-point exception handler using the
// _fpieee_flt function.
#include <fpieee.h>
#include <excpt.h>
#include <float.h>
#include <stddef.h>
int fpieee_handler( _FPIEEE_RECORD * );
int fpieee_handler( _FPIEEE_RECORD *pieee )
{
// user-defined ieee trap handler routine:
// there is one handler for all
// IEEE exceptions
// Assume the user wants all invalid
// operations to return 0.
if ((pieee->Cause.InvalidOperation) &&
(pieee->Result.Format == _FpFormatFp32))
{
pieee->Result.Value.Fp32Value = 0.0F;
return EXCEPTION_CONTINUE_EXECUTION;
}
else
return EXCEPTION_EXECUTE_HANDLER;
}
#define _EXC_MASK \
_EM_UNDERFLOW + \
_EM_OVERFLOW + \
_EM_ZERODIVIDE + \
_EM_INEXACT
int main( void )
{
// ...
__try {
// unmask invalid operation exception
_controlfp_s(NULL, _EXC_MASK, _MCW_EM);
// code that may generate
// fp exceptions goes here
}
__except ( _fpieee_flt( GetExceptionCode(),
GetExceptionInformation(),
fpieee_handler ) ){
// code that gets control
// if fpieee_handler returns
// EXCEPTION_EXECUTE_HANDLER goes here
}
// ...
}
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.