struttura DOT11_BYTE_ARRAY (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_BYTE_ARRAY precede un elenco di strutture a lunghezza variabile nel membro InformationBuffer del parametro OidRequest della funzione MiniportOidRequest.

Sintassi

typedef struct DOT11_BYTE_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfBytes;
  ULONG              uTotalNumOfBytes;
  UCHAR              ucBuffer[1];
} DOT11_BYTE_ARRAY, *PDOT11_BYTE_ARRAY;

Members

Header

Tipo, revisione e dimensioni della struttura DOT11_BYTE_ARRAY. 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 sulla revisione delle strutture a lunghezza variabile che seguono la struttura DOT11_BYTE_ARRAY. Per altre informazioni sulla revisione di queste strutture, vedere gli identificatori di oggetto (OIDS) elencati nella sezione "Vedere anche".

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_BYTE_ARRAY).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

uNumOfBytes

Numero di byte nella matrice ucBuffer .

uTotalNumOfBytes

Numero massimo di byte richiesti dalla matrice ucBuffer .

ucBuffer[1]

Elenco di strutture a lunghezza variabile.

Commenti

Il tipo di strutture archiviate nella matrice ucBuffer dipende dal set OID e dalla richiesta di query. Ad esempio, quando viene eseguita una query da OID_DOT11_ENUM_BSS_LIST, un driver miniport archivia una o più strutture DOT11_BSS_ENTRY nella matrice ucBuffer .

Quando viene eseguita una query da un OID che utilizza la struttura DOT11_BYTE_ARRAY, il driver miniport deve verificare che il membro InformationBuffer del parametro OidRequest della funzione MiniportOidRequest sia sufficientemente grande da restituire l'intera struttura, incluse tutte le voci nella matrice ucBuffer. 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_BYTE_ARRAY, il driver miniport deve eseguire le operazioni seguenti:
    • Per il parametro OidRequest , impostare il membro BytesWritten su zero e il membro BytesNeeded sulla lunghezza, in byte, dell'intera struttura DOT11_BYTE_ARRAY
    • 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 DOT11_BYTE_ARRAY, il driver miniport deve eseguire le operazioni seguenti per completare una richiesta di query riuscita:
    • Per la struttura DOT11_BYTE_ARRAY, impostare i membri uNumOfBytes e uTotalNumOfBytes sul numero totale di voci nella matrice ucBuffer .
    • Per il parametro OidRequest , impostare il membro BytesNeededed su zero e il membro BytesWritten sulla lunghezza, in byte, dell'intera struttura DOT11_BYTE_ARRAY. Il driver miniport deve anche copiare l'intera struttura DOT11_BYTE_ARRAY 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_CIPHER_KEY_MAPPING_KEY

OID_DOT11_ENUM_BSS_LIST

NDIS_OBJECT_HEADER