DOT11_PHY_TYPE_INFO struttura (windot11.h)

Importante L'interfaccia LAN wireless nativa 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver windows universale WLAN.

La struttura di DOT11_PHY_TYPE_INFO definisce i parametri usati dalla stazione 802.11 per configurare un PHY durante l'esecuzione di un'operazione di analisi esplicita. La stazione esegue l'operazione di analisi esplicita seguendo una richiesta impostata di OID_DOT11_SCAN_REQUEST.

Sintassi

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE dot11PhyType;
    ULONG          uPhyId;
  };
  BOOLEAN             bUseParameters;
  ULONG               uProbeDelay;
  ULONG               uMinChannelTime;
  ULONG               uMaxChannelTime;
  CH_DESCRIPTION_TYPE ChDescriptionType;
  ULONG               uChannelListSize;
  UCHAR               ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

Members

dot11PhyType

Tipo di PHY usato dalla stazione 802.11 per l'analisi. Il tipo PHY è definito dall'enumerazione DOT11_PHY_TYPE .

Nota Il driver miniport deve ignorare questo membro se è operativo in modalità Extensible Station (ExtSTA).

bUseParameters

Se questo membro è TRUE, la stazione 802.11 usa gli altri membri di questa struttura per configurare il PHY per l'operazione di analisi.

Se questo membro è FALSE, la stazione 802.11 configura il file PHY usando le proprie impostazioni per l'operazione di analisi.

Nota Se il driver miniport è operativo in modalità ExtSTA, il sistema operativo imposta sempre questo membro su FALSE.

uProbeDelay

Quantità di tempo, in microsecondi, che la stazione 802.11 deve attendere prima di trasmettere un frame di richiesta probe 802.11 durante l'analisi attiva.

uMinChannelTime

Quantità minima di tempo, in 802.11 unità temporali (TU), che la stazione 802.11 passa su ogni canale durante l'analisi. Un TU è 1024 microsecondi.

Questo membro deve essere maggiore o uguale a uProbeDelay .

uMaxChannelTime

Quantità massima di tempo, in 802.11 unità temporali (TU), che la stazione 802.11 spende su ogni canale durante l'analisi.

Questo membro deve essere maggiore o uguale a uProbeDelay .

ChDescriptionType

Questo membro specifica il metodo usato per interpretare le voci nella matrice ucChannelListBuffer . Il tipo di dati per questo membro è l'enumerazione CH_DESCRIPTION_TYPE, che dichiara i valori seguenti:

ch_description_type_logical

La voce del canale è definita da un numero di canale logico conforme allo standard IEEE 802.11.

ch_description_type_center_frequency

La voce del canale è definita, in unità di megahertz (MHz), in base a una frequenza centrale del canale.

uChannelListSize

Lunghezza, in byte, della matrice ucChannelListBuffer . Ogni voce di questa matrice viene formattata come tipo di dati ULONG.

ucChannelListBuffer[1]

Matrice contenente le descrizioni dei canali per il tipo PHY specificato nel membro dot11PhyType .

Commenti

La struttura DOT11_SCAN_REQUEST_V2 , che accompagna una richiesta set di OID_DOT11_SCAN_REQUEST, contiene una matrice di zero o più voci DOT11_PHY_TYPE_INFO.

Per altre informazioni sulle operazioni di analisi eseguite da un driver miniport nativo 802.11, vedere Operazioni di analisi native 802.11.

Per altre informazioni sulla modalità di operazione ExtSTA, vedere Modalità operazione Estendibile Stazione.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	windot11.h (include Ndis.h)

Vedi anche

DOT11_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST