structure WLAN_QOS_INFO (wlanapi.h)
Important
Certaines informations se rapportent à un produit de préversion qui peut être sensiblement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente des informations sur les quatre fonctionnalités décrites dans la spécification de gestion de la qualité de service Wi-Fi du WFA et définies dans la spécification 802.11.
Syntaxe
typedef struct _WLAN_QOS_INFO {
WLAN_QOS_CAPABILITIES interfaceCapabilities;
BOOL bConnected;
WLAN_CONNECTION_QOS_INFO connectionQoSInfo;
} WLAN_QOS_INFO, *PWLAN_QOS_INFO;
Membres
interfaceCapabilities
Type : WLAN_QOS_CAPABILITIES
Fonctionnalités QoS de l’interface.
bConnected
Type : BOOL
Indique s’il existe ou non une connexion établie. Si la valeur est TRUE
, connectionQoSInfo contient des informations QoS sur la connexion actuelle. Sinon, connectionoQoSInfo sera zéro.
connectionQoSInfo
Type : WLAN_CONNECTION_QOS_INFO
Informations sur les fonctionnalités QoS (décrites par la spécification WFA Wi-Fi gestion qoS) relatives à la connexion actuelle. Cette structure contient des informations pertinentes uniquement si bConnected est TRUE
; sinon, il s’agit de zéros et vous devez les ignorer.
Notes
Exemples
void DisplayQoSInfo(GUID interfaceGuid)
{
wil::unique_wlan_handle clientHandle;
const DWORD maxClientVersion = 2;
DWORD currentClientVersion = 0;
DWORD status = WlanOpenHandle(maxClientVersion, nullptr, ¤tClientVersion, &clientHandle);
if (status != ERROR_SUCCESS)
{
wprintf(L"WlanOpenHandle failed with error: %u\n", status);
return;
}
wil::unique_wlan_ptr<WLAN_QOS_INFO> qosInfo;
DWORD dataSize;
status = WlanQueryInterface(clientHandle.get(), &interfaceGuid, wlan_intf_opcode_qos_info, nullptr, &dataSize, wil::out_param_ptr<void **>(qosInfo), nullptr);
if (status != ERROR_SUCCESS)
{
wprintf(L"WlanQueryInterface failed with error %u\n", status);
return;
}
wprintf(
L"Interface QoS Capabilities: MSCS Supported = %u, DSCP To UP Mapping Supported = %u, SCS Supported = %u, DSCP Policy Supported = %u\n",
qosInfo->interfaceCapabilities.bMSCSSupported,
qosInfo->interfaceCapabilities.bDSCPToUPMappingSupported,
qosInfo->interfaceCapabilities.bSCSSupported,
qosInfo->interfaceCapabilities.bDSCPPolicySupported);
if (!qosInfo->bConnected)
{
// Not connected, so the data that follows in connectionQoSInfo is meaningless.
return;
}
const auto& connectionQoSInfo = qosInfo->connectionQoSInfo;
wprintf(
L"AP QoS Capabilities: MSCS Supported = %u, DSCP To UP Mapping Supported = %u, SCS Supported = %u, DSCP Policy Supported = %u\n",
connectionQoSInfo.peerCapabilities.bMSCSSupported,
connectionQoSInfo.peerCapabilities.bDSCPToUPMappingSupported,
connectionQoSInfo.peerCapabilities.bSCSSupported,
connectionQoSInfo.peerCapabilities.bDSCPPolicySupported);
wprintf(
L"Connection QoS Info:\n\tMSCS Configured = %u\n\tDSCP To UP Mapping Configured = %u\n\tNumber of SCS Streams = %u\n\tNumber of DSCP Policies = %u\n",
connectionQoSInfo.bMSCSConfigured,
connectionQoSInfo.bDSCPToUPMappingConfigured,
connectionQoSInfo.ulNumConfiguredSCSStreams,
connectionQoSInfo.ulNumConfiguredDSCPPolicies);
}
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | wlanapi.h |