DOT11_BYTE_ARRAY Struktur (windot11.h)
Wichtig
WiFiCx- ist das neue Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features nutzen zu können. Das WDI-Treibermodell befindet sich jetzt im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität.
Die DOT11_BYTE_ARRAY Struktur steht vor einer Liste von Strukturen mit variabler Länge im InformationBuffer Member des MiniportOidRequestOidRequest Parameter der Funktion.
Syntax
typedef struct DOT11_BYTE_ARRAY {
NDIS_OBJECT_HEADER Header;
ULONG uNumOfBytes;
ULONG uTotalNumOfBytes;
UCHAR ucBuffer[1];
} DOT11_BYTE_ARRAY, *PDOT11_BYTE_ARRAY;
Angehörige
Header
Der Typ, die Überarbeitung und die Größe der DOT11_BYTE_ARRAY Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.
Der Miniporttreiber muss die Member Header- auf die folgenden Werte festlegen:
Art
Dieses Element muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.
Revision
Dieses Element muss auf die Überarbeitung der Strukturen mit variabler Länge festgelegt werden, die der DOT11_BYTE_ARRAY Struktur folgen. Weitere Informationen zur Überarbeitung dieser Strukturen finden Sie in den im Abschnitt "Siehe auch" aufgeführten Objektbezeichnern (OIDS).
Größe
Dieses Element muss auf sizeof(DOT11_BYTE_ARRAY) festgelegt werden.
Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.
uNumOfBytes
Die Anzahl der Bytes im ucBuffer Array.
uTotalNumOfBytes
Die maximale Anzahl von Bytes, die vom ucBuffer Array benötigt werden.
ucBuffer[1]
Die Liste der Strukturen variabler Länge.
Bemerkungen
Der Typ der im ucBuffer Array gespeicherten Strukturen hängt von der OID-Menge und abfrageanforderung ab. Wenn z. B. von OID_DOT11_ENUM_BSS_LISTabgefragt wird, speichert ein Miniporttreiber eine oder mehrere DOT11_BSS_ENTRY Strukturen im ucBuffer- Array.
Wenn sie von einem OID abgefragt wird, das die DOT11_BYTE_ARRAY-Struktur verwendet, muss der Miniporttreiber überprüfen, ob das InformationBuffer-Element des MiniportOidRequestOidRequest Parameter groß genug ist, um die gesamte Struktur zurückzugeben, einschließlich aller Einträge im ucBuffer Array. Der Wert des InformationBufferLength Members des OidRequest Parameter bestimmt, was der Miniporttreiber tun muss, wie in der folgenden Liste dargestellt:
-
Wenn der Wert des InformationBufferLength Member kleiner als die Länge der gesamten DOT11_BYTE_ARRAY Struktur ist, muss der Miniporttreiber folgendes ausführen:
- Legen Sie für den parameter OidRequest das element BytesWritten auf null und das BytesNeededed Member auf die Länge der gesamten DOT11_BYTE_ARRAY Struktur in Byte fest.
- Schlägt die Abfrageanforderung fehl, indem NDIS_STATUS_BUFFER_OVERFLOW von der MiniportOidRequest--Funktion zurückgegeben wird.
-
Wenn der Wert des InformationBufferLength Member größer oder gleich der Länge der gesamten DOT11_BYTE_ARRAY Struktur ist, muss der Miniporttreiber folgendes ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
- Legen Sie für die DOT11_BYTE_ARRAY Struktur die uNumOfBytes- und uTotalNumOfBytes-Member auf die Gesamtanzahl der Einträge im ucBuffer Array fest.
- Legen Sie für den parameter OidRequest den BytesNeededed member auf null und das BytesWritten Member auf die Länge der gesamten DOT11_BYTE_ARRAY Struktur in Byte fest. Der Miniporttreiber muss auch die gesamte DOT11_BYTE_ARRAY Struktur in das InformationBuffer Member kopieren.
- Gibt NDIS_STATUS_SUCCESS aus der MiniportOidRequest--Funktion zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | windot11.h (include Ndis.h) |