funzione TSPI_lineClose (tspi.h)
La funzione TSPI_lineClose chiude il dispositivo a riga aperta specificato dopo aver completato o interrotto tutte le chiamate in sospeso e le operazioni asincrone nel dispositivo.
Sintassi
LONG TSPIAPI TSPI_lineClose(
HDRVLINE hdLine
);
Parametri
hdLine
Handle del provider di servizi per la riga da chiudere. Dopo la chiusura della riga, l'handle non è più valido.
Valore restituito
Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL LINEERR_RESOURCEUNAVAIL.
Commenti
Il provider di servizi deve segnalare il completamento per ogni operazione asincrona. Se viene chiamato TSPI_lineClose per una riga in cui sono presenti operazioni asincrone in sospeso, le operazioni vengono segnalate completate con un risultato o un codice di errore appropriato prima che questa procedura venga restituita.
Esiste un requisito simile per le chiamate attive sulla riga. Le operazioni in sospeso devono essere segnalate complete con i codici di errore o di risultato appropriati. Le chiamate attive devono essere eliminate, se necessario, e se questo comportamento è stato indicato dal bit LINEDEVCAPFLAGS_CLOSEDROP nella struttura LINEDEVCAPS .
Al termine di questa procedura, il provider di servizi non deve segnalare ulteriori htCall sulla riga o sulle chiamate presenti nella riga. Gli handle del provider di servizi per la riga e le chiamate sulla riga diventano "non validi".
Il provider di servizi deve rinunciare alle risorse non condivisibili che riserva mentre la riga è aperta. Ad esempio, la chiusura di una linea a cui si accede tramite una porta comm e un modem dovrebbe comportare la chiusura della porta comm, rendendola nuovamente disponibile per l'uso da parte di altre applicazioni.
Il provider di servizi non emette il messaggio di LINE_LINEDEVSTATE in risposta a questa chiamata di funzione perché la riga si chiude e non vi è più alcun interesse per le modifiche dello stato.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |