Inizializzazione TAPI coNDIS

Questa sezione illustra in che modo un driver miniport della rete WAN CoNDIS enumera le funzionalità TAPI per le applicazioni. Queste funzionalità TAPI sono costituite da:

• Il numero di dispositivi di linea supportati dal driver miniport—i dispositivi di linea includono, ad esempio, un modem, una scheda fax e una scheda ISDN.

• Le informazioni relative a righe specifiche includono, ad esempio, un identificatore di riga e il numero di indirizzi di canale (numeri di telefono) supportati per la trasmissione simultanea di dati e voce.

• Le informazioni relative agli indirizzi di canale specifici su linee di dispositivi includono, ad esempio, l'identità di un chiamante (ID chiamante) e il numero di chiamate attive possibili.

Per recuperare informazioni sull'hardware sottostante, NDPROXY genera richieste per le funzionalità line-address e channel-address. Ovvero, il driver NDPROXY esegue una query sulle funzionalità TAPI di un driver miniport della rete WAN CoNDIS. Il driver NDPROXY chiama la funzione NdisCoOidRequest per eseguire query sulle funzionalità TAPI del driver miniport. In questa chiamata NDPROXY passa una struttura NDIS_OID_REQUEST. NDPROXY specifica quanto segue in NDIS_OID_REQUEST:

• Valore di NdisRequestQueryInformation nel membro RequestType

• Identificatore di oggetto (OID) che specifica la funzionalità TAPI da recuperare dal driver miniport nel membro Oid

• Buffer per contenere le informazioni sulle funzionalità TAPI restituite nel membro InformationBuffer

Tutte le query inviate a un driver miniport WAN CoNDIS dal driver NDPROXY possono essere completate in modo sincrono o asincrono. Se un driver miniport della rete WAN CoNDIS determina che non può completare immediatamente la query, può semplicemente restituire NDIS_STATUS_PENDING e chiamare la funzione NdisMCmOidRequestComplete dall'interno della relativa funzione ProtocolCoOidRequest al termine della query.

Dopo che un driver miniport CoNDIS WAN notifica a NDPROXY la registrazione di una nuova famiglia di indirizzi come specificato in CoNDIS TAPI Registration, NDPROXY esegue una query sugli OID seguenti per determinare le funzionalità specifiche di TAPI del driver miniport della rete WAN CoNDIS e della scheda di interfaccia di rete del driver miniport.

• NDPROXY esegue una query sul driver miniport con OID_CO_TAPI_CM_CAPS per determinare il numero di righe supportate dal dispositivo del driver miniport (il dispositivo per cui fornisce servizi TAPI). Questo OID richiede anche al driver miniport di indicare se queste linee hanno funzionalità di linea diverse.

• NDPROXY interroga il driver miniport con OID_CO_TAPI_LINE_CAPS per determinare le funzionalità di telefonia per la linea specificata. Questo OID richiede anche al driver miniport di indicare se gli indirizzi in questa riga hanno funzionalità di indirizzo diverse.

  • Se la query precedente di OID_CO_TAPI_CM_CAPS indica che il dispositivo del driver miniport supporta solo una linea o se il dispositivo supporta più linee con le stesse funzionalità di linea, NDPROXY deve eseguire una query su OID_CO_TAPI_LINE_CAPS una sola volta per ottenere le funzionalità di linea del dispositivo. In questo caso, le funzionalità delle linee restituite dal driver miniport si applicano a tutte le linee del dispositivo.
  • Se il dispositivo supporta più righe con funzionalità di linea diverse, NDPROXY deve eseguire una query OID_CO_TAPI_LINE_CAPS una volta per ogni riga per ottenere le funzionalità di riga di ogni riga.

• Infine, NDPROXY esegue una query sul driver miniport con OID_CO_TAPI_ADDRESS_CAPS per determinare le capacità di telefonia per un indirizzo specificato su una linea specificata.

  • Se la query precedente di OID_CO_TAPI_LINE_CAPS indica che la riga supporta un solo indirizzo o che tutti gli indirizzi nella riga hanno le stesse funzionalità di indirizzo, le query NDPROXY OID_CO_TAPI_ADDRESS_CAPS una sola volta per determinare le funzionalità di tutti gli indirizzi nella riga.
  • Se una linea supporta più indirizzi con funzionalità diverse, NDPROXY invia una query OID_CO_TAPI_ADDRESS_CAPS una volta per ogni indirizzo sulla linea.

Il driver NDPROXY usa le informazioni ottenute con gli ID di enumerazione TAPI per eseguire le operazioni seguenti:

• Creare parametri TAPI per le chiamate TAPI successive.

• Determinare se accettare o rifiutare le chiamate TAPI in arrivo successive.

• Registrare uno o più punti di accesso al servizio TAPI (SAP) in cui ricevere le successive chiamate TAPI in ingresso.