struttura DOT11_PHY_ID_LIST (windot11.h)
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 .
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) |