ASYNC_COMPLETION funzione di callback (tspi.h)

Articolo
03/13/2024

Completion_Proc è una funzione di callback implementata da TAPI e fornita al provider di servizi come parametro per TSPI_providerInit. Il provider di servizi chiama questa funzione per segnalare il completamento di una procedura di riga o telefono eseguita in modo asincrono.

Il tipo ASYNC_COMPLETION definisce un puntatore a questa funzione di callback. Completion_Proc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

ASYNC_COMPLETION AsyncCompletion;

void AsyncCompletion(
  DRV_REQUESTID dwRequestID,
  LONG lResult
)
{...}

Parametri

dwRequestID

Identificatore passato nella richiesta originale eseguita dal provider di servizi in modo asincrono.

lResult

Risultato dell'operazione. Può essere zero per indicare l'esito positivo o un numero negativo per indicare un errore. I possibili valori di errore specifici che possono derivare da una funzione sono gli stessi per l'esecuzione asincrona o sincrona.

Valore restituito

nessuno

Osservazioni

Lo stato della chiamata quando si chiama questa funzione può essere qualsiasi stato.

Questa procedura viene fornita da TAPI al momento dell'inizializzazione di un provider di servizi con la funzione TSPI_providerInit . Alcune delle procedure TSPI che operano su dispositivi in linea, chiamata e telefono specificano l'operazione asincrona. Queste procedure includono un parametro dwRequestID per identificare la richiesta. Quando viene chiamata una procedura di questo tipo, il provider di servizi può restituire un numero negativo per un errore se ne viene rilevato immediatamente uno o il valore dwRequestID positivo se l'operazione continua in modo asincrono. Il provider di servizi deve segnalare il completamento una sola volta per ogni richiesta eseguita in modo asincrono. A tale scopo, chiamare questa procedura. Il provider di servizi non è autorizzato a chiamare questa routine o la Line_Event o Phone_Event routine fino a quando non viene restituita la procedura.

Il provider di servizi è autorizzato a chiamare la funzione Completion_Proc prima che venga restituita dalla prima richiesta. TAPI garantisce di non chiamare il provider di servizi dall'interno del contesto di Completion_Proc tranne dove indicato.

Ciò non ha alcuna corrispondenza diretta a livello TAPI perché a quel livello i completamenti asincroni delle funzioni vengono segnalati come messaggio passato attraverso la stessa interfaccia di callback usata per i messaggi di evento spontaneo. A livello TSPI, gli eventi spontanei vengono segnalati tramite le procedure di callback Line_Event e Phone_Event .