DOT11_WFD_DISCOVER_REQUEST-Struktur (windot11.h)
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;
Member
Header
Typ, Revision und Größe derOID_DOT11_WFD_DISCOVER_REQUEST-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.
Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:
Typ
Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.
Revision
Dieser Member muss auf DOT11_WFD_DISCOVER_REQUEST_REVISION_1 festgelegt werden.
Size
Dieser Member muss auf sizeof(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1) festgelegt werden.
Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.
DiscoverType
Der zu verwendende Geräteermittlungsmodus.
ScanType
Scantyp, der während der Überprüfungsphase der Geräteermittlung verwendet wird.
uDiscoverTimeout
Maximale Zeit in Millisekunden, um den Ermittlungsvorgang abzuschließen. Ein Miniport kann eine Ermittlung in kürzerer Zeit durchführen, sollte jedoch nicht mehr Zeit in Anspruch nehmen, als durch diesen Wert angegeben wird. 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 direkten Geräteermittlung gesucht werden soll. Dieser Offset wird in Bytes angegeben und ist 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 Geräte-ID-Attribut der P2P-IEs verwenden, die er in den Testanforderungen enthält.
Der Offset im InformationBuffer des NDIS_OID_REQUEST , an dem eine Liste der P2P-Gerätebezeichner beginnt. Dies sind die Bezeichner, für die während der Geräteermittlung verwendet werden soll.
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
Der Offset im InformationBuffer der NDIS_OID_REQUEST Struktur, in der die zusätzlichen Informationselemente (IEs) beginnen.
uIEsLength
Die Länge der zusätzlichen IEs in Bytes, die der Wi-Fi Direct-Geräteport dem Testanforderungspaket hinzufügen muss. Wenn dieser Wert 0 ist, hat das System keine IEs bereitgestellt, und der Miniport muss die Standard-IEs in das Testanforderungspaket einfügen. Die Standard-IEs befinden sich in DefaultRequestIEs, die zuvor mit einer OID_DOT11_WFD_ADDITIONAL_IE-Anforderung empfangen wurden.
bForceScanLegacyNetworks
Bei TRUE muss das Wi-Fi Direct-Gerät auch versuchen, Legacynetzwerke zu ermitteln. Andernfalls ist die Überprüfung auf Legacynetzwerke nicht erforderlich.
Hinweise
Jeder Eintrag in der Gerätebezeichnerliste unter uDeviceFilterListOffset ist als DOT11_MAC_ADDRESS-Struktur formatiert. Wenn in dieser Liste eine nicht übertragene MAC-Adresse angegeben ist, muss der Treiber diese Adresse im Geräte-ID-Attribut des P2P-IEs-Tests verwenden, die er überträgt.
Die in uIEsOffset vorhandenen IEs ersetzen für die Dauer der Geräteermittlung vorübergehend IEs, die unter DefaultRequestIEs in der Eingabestruktur der OID_DOT11_WFD_ADDITIONAL_IE-Anforderung gefunden wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Versionen:_Supported in Windows 8 |
| Kopfzeile | windot11.h (einschließlich Windot11.h) |