struktur DOT11_WFD_DISCOVER_REQUEST (windot11.h)

Artikel
02/27/2024

Penting Antarmuka LAN Nirkabel Native 802.11 tidak digunakan lagi di Windows 10 dan yang lebih baru. Silakan gunakan WLAN Device Driver Interface (WDI) sebagai gantinya. Untuk informasi selengkapnya tentang WDI, lihat WLAN Universal Windows driver model.

Struktur OID_DOT11_WFD_DISCOVER_REQUEST adalah data input untuk permintaan OID_DOT11_WFD_DISCOVER_REQUEST . Struktur berisi parameter untuk penemuan perangkat Wi-Fi Direct.

Sintaks

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;

Anggota

Header

Jenis, revisi, dan ukuran strukturOID_DOT11_WFD_DISCOVER_REQUEST . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Driver miniport harus mengatur anggota Header ke nilai berikut:

Jenis

Anggota ini harus diatur ke NDIS_OBJECT_TYPE_DEFAULT.

Revisi

Anggota ini harus diatur ke DOT11_WFD_DISCOVER_REQUEST_REVISION_1.

Ukuran

Anggota ini harus diatur ke sizeof(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1).

Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.

DiscoverType

Mode penemuan perangkat yang akan digunakan.

ScanType

Jenis pemindaian yang digunakan selama fase pemindaian penemuan perangkat.

uDiscoverTimeout

Waktu maksimum, dalam milidetik, untuk menyelesaikan operasi penemuan. Miniport dapat menyelesaikan penemuan dalam waktu yang lebih singkat, namun, tidak boleh menggunakan waktu lebih lama dari yang ditentukan oleh nilai ini. Ini adalah total waktu yang diizinkan untuk menyelesaikan semua fase penemuan perangkat.

uDeviceFilterListOffset

Offset ke daftar filter Perangkat P2P, yang menentukan perangkat P2P dan Pemilik Grup untuk dicari selama penemuan perangkat Wi-Fi Direct. Offset ini ditentukan dalam byte dan relatif terhadap awal buffer yang berisi struktur DOT11_WFD_DISCOVER_REQUEST. Setiap entri dalam daftar diformat sebagai DOT11_WFD_DISCOVER_DEVICE_FILTER.

Ketika entri daftar menentukan alamat MAC yang tidak disiarkan sebagai ID Perangkat, driver harus menggunakan alamat MAC ini di Atribut ID Perangkat dari IEs P2P yang disertakan dalam permintaan pemeriksaan.

Offset dalam InformationBufferdari NDIS_OID_REQUEST tempat daftar pengidentifikasi perangkat P2P dimulai. Ini adalah pengidentifikasi untuk selama penemuan perangkat.

uNumDeviceFilters

Jumlah filter perangkat P2P yang akan digunakan selama penemuan perangkat WFD. Nilai default untuk bidang ini adalah 0.

uIEsOffset

Offset dalam InformationBuffer dari struktur NDIS_OID_REQUEST tempat Elemen Informasi (IEs) tambahan dimulai.

uIEsLength

Panjangnya, dalam byte, dari IEs tambahan yang harus ditambahkan port perangkat Wi-Fi Direct ke paket permintaan probe. Jika nilai ini adalah 0, sistem tidak menyediakan IEs apa pun dan miniport harus menyisipkan IEs default dalam paket permintaan pemeriksaan. IEs default ada di DefaultRequestIEs yang diterima sebelumnya dengan permintaan OID_DOT11_WFD_ADDITIONAL_IE .

bForceScanLegacyNetworks

Ketika TRUE, perangkat Wi-Fi Direct juga harus mencoba menemukan jaringan warisan. Jika tidak, pemindaian untuk jaringan warisan tidak diperlukan.

Keterangan

Setiap entri dalam daftar pengidentifikasi perangkat di uDeviceFilterListOffset diformat sebagai struktur DOT11_MAC_ADDRESS . Ketika alamat MAC yang tidak disiarkan ditentukan dalam daftar ini, driver harus menggunakan alamat ini di atribut ID Perangkat dari permintaan pemeriksaan IEs P2P yang dikirimkannya

IEs yang ada di uIEsOffset, selama durasi penemuan perangkat, akan menggantikan IEs yang ditemukan di DefaultRequestIEs untuk sementara dalam struktur input permintaan OID_DOT11_WFD_ADDITIONAL_IE .