Condividi tramite

OID_CO_TAPI_LINE_CAPS

  • Articolo

Il OID_CO_TAPI_LINE_CAPS OID richiede un gestore chiamate o un driver di gestione chiamate miniport integrato (MCM) per restituire le funzionalità di telefonia per una riga specificata. Questo OID richiede anche al gestore chiamate o al driver MCM di indicare se gli indirizzi in questa riga hanno funzionalità di telefonia diverse.

Questa richiesta usa una struttura CO_TAPI_LINE_CAPS, definita come segue, per eseguire query sulle funzionalità di telefonia di una riga specificata:

typedef struct _CO_TAPI_LINE_CAPS {
    IN  ULONG           ulLineID;
    OUT ULONG           ulFlags;
    OUT LINE_DEV_CAPS   LineDevCaps;
} CO_TAPI_LINE_CAPS, *PCO_TAPI_LINE_CAPS;

I membri di questa struttura contengono le informazioni seguenti:

ulLineID
Specifica la riga per cui devono essere restituite le funzionalità di telefonia. ulLineID è un identificatore in base zero.

ulFlags
Se la riga supporta più indirizzi con funzionalità di telefonia diverse, il gestore chiamate o il driver MCM imposta il bit di CO_TAPI_FLAG_PER_ADDRESS_CAPS in ulFlags; in caso contrario, il gestore chiamate o il driver MCM cancella questo bit. Tutti i bit non definiti sono riservati e devono essere impostati su 0.

LineDevCaps
Specifica le funzionalità di telefonia di una riga, formattate come struttura LINE_DEV_CAPS. Per altre informazioni su questa struttura, vedere il Microsoft Windows SDK e il file di intestazione ndistapi.h.

Commenti

Dopo aver eseguito una query sulle funzionalità di telefonia del dispositivo del gestore chiamate o del driver MCM con OID_CO_TAPI_CM_CAPS, un client orientato alla connessione esegue query sulle funzionalità di telefonia delle linee supportate dal dispositivo.

  • Se tutte le righe supportate dal dispositivo hanno le stesse funzionalità di riga e tutti gli indirizzi in queste righe hanno le stesse funzionalità di indirizzo, le query client OID_CO_TAPI_LINE_CAPS una volta per ottenere le funzionalità di riga del dispositivo. In questo caso, le funzionalità della riga restituite dal gestore chiamate o dal driver MCM si applicano a tutte le righe supportate dal dispositivo.
  • Se il dispositivo supporta più righe con funzionalità diverse, tuttavia, e/o se gli indirizzi in queste righe hanno funzionalità di indirizzi diversi, le query client OID_CO_TAPI_LINE_CAPS una volta per ogni riga supportata dal dispositivo per ottenere le funzionalità di ogni riga di ogni riga.

L'impostazione ulFlags determina il numero di volte in cui il client esegue successivamente query sulle funzionalità dell'indirizzo (es) nella riga:

  • Se la riga supporta un solo indirizzo o se la riga supporta più indirizzi con le stesse funzionalità di indirizzo, le query client OID_CO_TAPI_ADDRESS_CAPS una sola volta.
  • Se la riga supporta più indirizzi con funzionalità diverse, il client deve eseguire una query OID_CO_TAPI_ADDRESS_CAPS una volta per ogni indirizzo nella riga.

Requisiti

Versione: Windows Vista e intestazione successiva: Ntddndis.h (include Ndis.h)