struttura DOT11_WFD_DISCOVER_REQUEST (windot11.h)

Articolo
02/07/2025

Importante

WiFiCx è il nuovo modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti. Il modello di driver WDI è ora in modalità di manutenzione e riceverà solo correzioni ad alta priorità.

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'individuazione dei dispositivi diretta Wi-Fi.

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;

Membri

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 Header sui valori seguenti:

Digitare

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_WFD_DISCOVER_REQUEST_REVISION_1.

Grandezza

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, espresso in millisecondi, per completare l'operazione di individuazione. Un miniport può completare un'individuazione in meno tempo, ma non deve usare più tempo rispetto a quanto 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 del dispositivo P2P, che specifica i dispositivi P2P e i proprietari del gruppo da cercare durante Wi-Fi individuazione diretta dei dispositivi. Questo offset viene specificato in byte ed è relativo all'inizio del buffer che contiene la struttura DOT11_WFD_DISCOVER_REQUEST. Ogni voce dell'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 nel InformationBuffer del NDIS_OID_REQUEST in cui inizia un elenco di identificatori di dispositivo P2P. Questi sono gli identificatori da per durante l'individuazione dei dispositivi.

uNumDeviceFilters

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

uIEsOffset

Offset nella InformationBuffer della struttura NDIS_OID_REQUEST in cui iniziano gli elementi informativi aggiuntivi (IEs).

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 si trovano in DefaultRequestIEs ricevuti in precedenza con una richiesta di OID_DOT11_WFD_ADDITIONAL_IE.

bForceScanLegacyNetworks

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

Osservazioni

Ogni voce nell'elenco di identificatori di dispositivo in uDeviceFilterListOffset viene formattata come struttura DOT11_MAC_ADDRESS. Quando in questo elenco viene specificato un indirizzo MAC non broadcast, 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 gli IEs trovati in DefaultRequestIEs nella struttura di input della richiesta di OID_DOT11_WFD_ADDITIONAL_IE.