struttura DOT11_PHY_ID_LIST (windot11.h)

  • Articolo
Importante L'interfaccia LAN wireless native 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 DOT11_PHY_ID_LIST specifica un elenco di zero o più tipi PHY.

Sintassi

typedef struct DOT11_PHY_ID_LIST {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfEntries;
  ULONG              uTotalNumOfEntries;
  ULONG              dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;

Members

Header

Tipo, revisione e dimensioni della struttura DOT11_PHY_ID_LIST. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare i membri di Header sui valori seguenti:

Tipo

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_PHY_ID_LIST_REVISION_1.

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_PHY_ID_LIST).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

uNumOfEntries

Numero di voci nella matrice dot11PhyId .

uTotalNumOfEntries

Numero massimo di voci che la matrice dot11PhyId può contenere.

dot11PhyId[1]

Elenco di identificatori PHY (ID).

Commenti

Un ID PHY nella matrice dot11PhyId deve essere uno dei seguenti:

  • Indice nella tabella dei PHY supportati definiti dall'oggetto MiB (Native 802.11 Operational msDot11SupportedPhyTypes ). Per altre informazioni sugli ID PHY e sull'oggetto MIB msDot11SupportedPhyTypes , vedere OID_DOT11_SUPPORTED_PHY_TYPES.
  • ID PHY con il valore di DOT11_PHY_ID_ANY. Questo ID PHY è denominato ID PHY con caratteri jolly e viene usato per specificare qualsiasi PHY supportato nella stazione 802.11. Se viene usato l'ID PHY con caratteri jolly, deve essere l'unica voce nella matrice dot11PhyId .
Un driver miniport restituisce la struttura DOT11_PHY_ID_LIST quando viene eseguita una query tramite OID_DOT11_ACTIVE_PHY_LIST o OID_DOT11_DESIRED_PHY_LIST.

Quando vengono eseguite query su questi IDE, il driver miniport deve verificare che il membro InformationBuffer del parametro OidRequest della funzione MiniportOidRequest sia sufficientemente grande da restituire l'intera struttura DOT11_PHY_ID_LIST, incluse tutte le voci nella matrice dot11PhyId. Il valore del membro InformationBufferLength del parametro OidRequest determina le operazioni che il driver miniport deve eseguire, come illustrato nell'elenco seguente:

  • Se il valore del membro InformationBufferLength è minore della lunghezza, espressa in byte, dell'intera struttura DOT11_PHY_ID_LIST, il driver miniport deve eseguire le operazioni seguenti:
    • Impostare il membro uNumOfEntries su zero.
    • Impostare il membro uTotalNumOfEntries sul numero di voci nella matrice dot11PhyId .
    • Per il parametro OidRequest , impostare il membro BytesWritten su zero e il membro BytesNeededed sulla lunghezza, in byte, dell'intera struttura DOT11_PHY_ID_LIST.
    • Interrompere la richiesta di query restituendo NDIS_STATUS_BUFFER_OVERFLOW dalla relativa funzione MiniportOidRequest .
  • Se il valore del membro InformationBufferLength è maggiore o uguale alla lunghezza, in byte, dell'intera struttura di DOT11_PHY_ID_LIST, il driver miniport deve eseguire le operazioni seguenti per completare una richiesta di query riuscita:
    • Per la struttura DOT11_PHY_ID_LIST, impostare i membri uNumOfEntries e uTotalNumOfEntries sul numero totale di voci nella matrice dot11PhyId .
    • Per il parametro OidRequest , impostare il membro BytesNeededed su zero e il membro BytesWritten sulla lunghezza, in byte, dell'intera struttura DOT11_PHY_ID_LIST. Il driver miniport deve anche copiare l'intera struttura DOT11_PHY_ID_LIST nel membro InformationBuffer .
    • Restituisce NDIS_STATUS_SUCCESS dalla funzione MiniportOidRequest .

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

OID_DOT11_ACTIVE_PHY_LIST

OID_DOT11_DESIRED_PHY_LIST

NDIS_OBJECT_HEADER