DOT11_WFD_DISCOVER_REQUEST struttura (windot11.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless nativa 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 OID_DOT11_WFD_DISCOVER_REQUEST è i dati di input per una richiesta di OID_DOT11_WFD_DISCOVER_REQUEST . La struttura contiene i parametri per un Wi-Fi individuazione dei dispositivi Direct.

Sintassi

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;

Members

Header

Tipo, revisione e dimensione della strutturaOID_DOT11_WFD_DISCOVER_REQUEST . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare i membri di Intestazione sui valori seguenti:

Tipo

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_WFD_DISCOVER_REQUEST_REVISION_1.

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

DiscoverType

Modalità di individuazione dei dispositivi da usare.

ScanType

Tipo di analisi usato durante la fase di analisi dell'individuazione dei dispositivi.

uDiscoverTimeout

Tempo massimo, in millisecondi, per completare l'operazione di individuazione. Un miniport può completare un'individuazione in meno tempo, tuttavia, non deve usare più tempo rispetto a quello specificato da questo valore. Questo è il tempo totale consentito per il completamento di tutte le fasi di individuazione dei dispositivi.

uDeviceFilterListOffset

Offset all'elenco dei filtri dispositivo P2P, che specifica i dispositivi P2P e i proprietari di gruppi da cercare durante l'individuazione diretta dei dispositivi Wi-Fi. Questo offset viene specificato in byte ed è relativo all'inizio del buffer che contiene la struttura DOT11_WFD_DISCOVER_REQUEST. Ogni voce nell'elenco viene formattata come DOT11_WFD_DISCOVER_DEVICE_FILTER.

Quando una voce di elenco specifica un indirizzo MAC non trasmesso come ID dispositivo, il driver deve usare questo indirizzo MAC nell'attributo ID dispositivo degli IES P2P inclusi nelle richieste probe.

Offset nell'oggetto InformationBuffer della NDIS_OID_REQUEST in cui inizia un elenco di identificatori di dispositivo P2P. Questi sono gli identificatori da usare durante l'individuazione dei dispositivi.

uNumDeviceFilters

Numero di filtri dei dispositivi P2P da usare durante l'individuazione dei dispositivi WFD. Il valore predefinito per questo campo è 0.

uIEsOffset

Offset nella struttura InformationBuffer della struttura NDIS_OID_REQUEST in cui iniziano gli elementi informational (IES) aggiuntivi.

uIEsLength

Lunghezza, in byte, degli IES aggiuntivi che la porta del dispositivo diretto Wi-Fi deve aggiungere al pacchetto di richiesta probe. Se questo valore è 0, il sistema non ha fornito alcun IES e il miniport deve inserire gli IES predefiniti nel pacchetto di richiesta probe. Gli IES predefiniti sono in DefaultRequestIEs ricevuti in precedenza con una richiesta di OID_DOT11_WFD_ADDITIONAL_IE .

bForceScanLegacyNetworks

Quando TRUE, il dispositivo direct Wi-Fi deve anche tentare di individuare le reti legacy. In caso contrario, l'analisi delle reti legacy non è necessaria.

Commenti

Ogni voce nell'elenco degli identificatori di dispositivo in uDeviceFilterListOffset viene formattata come struttura DOT11_MAC_ADDRESS . Quando viene specificato un indirizzo MAC non trasmesso in questo elenco, il driver deve usare questo indirizzo nell'attributo ID dispositivo del probe IEs P2P che trasmette

Gli IES presenti in uIEsOffset, per la durata dell'individuazione del dispositivo, sostituiranno temporaneamente IEs trovati in DefaultRequestIEs nella struttura di input della richiesta di OID_DOT11_WFD_ADDITIONAL_IE .