estrutura WLAN_RAW_DATA_LIST (wlanapi.h)
A estrutura WLAN_RAW_DATA_LIST contém dados brutos na forma de uma matriz de blobs de dados que são usados por algumas funções wi-fi nativas.
Sintaxe
typedef struct _WLAN_RAW_DATA_LIST {
DWORD dwTotalSize;
DWORD dwNumberOfItems;
struct {
DWORD dwDataOffset;
DWORD dwDataSize;
};
__unnamed_struct_1945_1 DataList[1];
} WLAN_RAW_DATA_LIST, *PWLAN_RAW_DATA_LIST;
Membros
dwTotalSize
O tamanho total, em bytes, da estrutura WLAN_RAW_DATA_LIST .
dwNumberOfItems
O número de entradas de dados brutos ou blobs na estrutura WLAN_RAW_DATA_LIST . O valor máximo de dwNumberOfItems pode ser restrito pelo tipo de dados armazenado na estrutura WLAN_RAW_DATA_LIST .
dwDataOffset
dwDataSize
DataList[1]
Uma matriz de entradas de dados brutos ou blobs que compõem a lista de dados.
dwDataOffset
O deslocamento, em bytes, do blob de dados desde o início do descritor de blob atual. Para obter detalhes, consulte o exemplo na seção Comentários abaixo.
dwDataSize
O tamanho, em bytes, do blob de dados.
Comentários
A estrutura WLAN_RAW_DATA_LIST é usada para encapsular uma lista de blobs de dados em um bloco de memória simples. Ele deve ser interpretado como uma lista de cabeçalhos seguidos por blobs de dados.
Para criar um WLAN_RAW_DATA_LIST, um aplicativo precisa alocar um bloco de memória grande o suficiente para manter os cabeçalhos e os blobs de dados e, em seguida, converter o bloco de memória em um ponteiro para uma estrutura WLAN_RAW_DATA_LIST .
Veja a seguir o layout de memória de um exemplo WLAN_RAW_DATA_LIST estrutura que contém dois blobs de dados.
| Deslocamento de memória | Campo | Valor | Comentários |
| 0 | Dwtotalsize | 84 | |
| 4 | dwNumberOfItems | 2 | |
| 8 | dwDataOffset | 16 | Deslocamento do primeiro blob: 16 = 24 - 8 |
| 12 | dwDataSize | 20 | Tamanho do primeiro blob. |
| 16 | dwDataOffset | 28 | Deslocamento do segundo blob: 44 a 16. |
| 20 | dwDataSize | 24 | Tamanho do segundo blob. |
| 24 | 20 | Início do primeiro blob. | |
| 44 | 40 | Início do segundo blob. |
A estrutura WLAN_RAW_DATA_LIST atualmente é usada pela função WlanSetPsdIEDataList para definir a lista de dados do elemento de informação PSD (descoberta de serviço de proximidade) para um aplicativo.
Quando usada para armazenar uma lista de dados do PSD IE, a constante DOT11_PSD_IE_MAX_ENTRY_NUMBER definida no arquivo de cabeçalho Wlanapi.h é o valor máximo do membro dwNumberOfItems para o número de blobs na estrutura WLAN_RAW_DATA_LIST . A constante DOT11_PSD_IE_MAX_DATA_SIZE definida no arquivo de cabeçalho Wlanapi.h é o valor máximo do membro dwDataSize para qualquer blob.
| Constante | Valor | Descrição |
|---|---|---|
| DOT11_PSD_IE_MAX_DATA_SIZE | 240 | O tamanho máximo dos dados, em bytes, de uma entrada de dados do PSD IE. |
| DOT11_PSD_IE_MAX_ENTRY_NUMBER | 5 | O número máximo de entradas de dados do PSD IE. |
Para obter mais informações sobre IEs PSD, incluindo uma discussão sobre o formato de um IE, consulte WlanSetPsdIEDataList.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho | wlanapi.h (inclua Wlanapi.h) |