DOT11_WFD_DISCOVER_REQUEST 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 OID_DOT11_WFD_DISCOVER_REQUEST Struktur ist die Eingabedaten für eine OID_DOT11_WFD_DISCOVER_REQUEST Anforderung. Die Struktur enthält die Parameter für eine Wi-Fi Direct Device Discovery.
Syntax
typedef struct _DOT11_WFD_DISCOVER_REQUEST {
NDIS_OBJECT_HEADER Header;
DOT11_WFD_DISCOVER_TYPE DiscoverType;
DOT11_WFD_SCAN_TYPE ScanType;
ULONG uDiscoverTimeout;
ULONG uDeviceFilterListOffset;
ULONG uNumDeviceFilters;
ULONG uIEsOffset;
ULONG uIEsLength;
BOOLEAN bForceScanLegacyNetworks;
} DOT11_WFD_DISCOVER_REQUEST, *PDOT11_WFD_DISCOVER_REQUEST;
Angehörige
Header
Der Typ, die Überarbeitung und die Größe derOID_DOT11_WFD_DISCOVER_REQUEST 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_DEFAULTfestgelegt werden.
Revision
Dieses Element muss auf DOT11_WFD_DISCOVER_REQUEST_REVISION_1festgelegt werden.
Größe
Dieses Element muss auf Größe(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1) festgelegt sein.
Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.
DiscoverType
Der zu verwendende Geräteermittlungsmodus.
ScanType
Scantyp, der während der Scanphase der Geräteermittlung verwendet wird.
uDiscoverTimeout
Maximale Zeit in Millisekunden, um den Ermittlungsvorgang abzuschließen. Ein Miniport kann eine Ermittlung in kürzerer Zeit abschließen, sollte jedoch nicht mehr Zeit als durch diesen Wert angegeben verwenden. Dies ist die gesamt zulässige Zeit für den Abschluss aller Phasen der Geräteermittlung.
uDeviceFilterListOffset
Der Offset zur Liste der P2P-Gerätefilter, der die P2P-Geräte und Gruppenbesitzer angibt, nach denen während Wi-Fi direct device discovery gesucht werden soll. Dieser Offset wird in Byte angegeben und relativ zum Anfang des Puffers, der die DOT11_WFD_DISCOVER_REQUEST Struktur enthält. Jeder Eintrag in der Liste ist als DOT11_WFD_DISCOVER_DEVICE_FILTER formatiert.
Wenn ein Listeneintrag eine nicht übertragene MAC-Adresse als Geräte-ID angibt, muss der Treiber diese MAC-Adresse im Device ID-Attribut der P2P-IEs verwenden, die er in die Probeanforderungen einschließt.
Der Offset im InformationBuffer- des NDIS_OID_REQUEST, in dem eine Liste der P2P-Gerätebezeichner beginnt. Dies sind die Bezeichner für die Geräteermittlung.
uNumDeviceFilters
Die Anzahl der P2P-Gerätefilter, die während der WFD-Geräteermittlung verwendet werden sollen. Der Standardwert für dieses Feld ist 0.
uIEsOffset
The offset in the InformationBuffer of the NDIS_OID_REQUEST structure where the additional Informational Elements (IEs) begin.
uIEsLength
Die Länge der zusätzlichen IEs, die der Wi-Fi Direct Device Port zum Probeanforderungspaket hinzufügen muss. Wenn dieser Wert 0 ist, hat das System keine IEs bereitgestellt, und der Miniport muss die Standard-IEs in das Probeanforderungspaket einfügen. Die Standard-IEs befinden sich in DefaultRequestIEs, die zuvor mit einer OID_DOT11_WFD_ADDITIONAL_IE-Anforderung empfangen wurden.
bForceScanLegacyNetworks
Wenn TRUE, muss das Wi-Fi Direct-Gerät auch versuchen, ältere Netzwerke zu ermitteln. Andernfalls ist die Suche nach älteren Netzwerken nicht erforderlich.
Bemerkungen
Jeder Eintrag in der Gerätebezeichnerliste bei uDeviceFilterListOffset ist als DOT11_MAC_ADDRESS Struktur formatiert. Wenn eine nicht übertragene MAC-Adresse in dieser Liste angegeben ist, muss der Treiber diese Adresse im Attribut "Geräte-ID" des P2P-IEs-Prüfpunkts verwenden, der übertragen wird.
Die IEs, die bei uIEsOffsetvorhanden sind, ersetzen für die Dauer der Geräteermittlung vorübergehend IEs, die bei DefaultRequestIEs in der Eingabestruktur der OID_DOT11_WFD_ADDITIONAL_IE-Anforderung gefunden wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Versionen:_Supported in Windows 8 |
| Header- | windot11.h (einschließlich Windot11.h) |