Funzione MgmGetFirstMfeStats (mgm.h)

Articolo
03/05/2024

La funzione MgmGetFirstMfeStats recupera le statistiche MFE a partire dall'inizio dell'elenco MFE. La funzione può recuperare zero, uno o più set di statistiche MFE. Il numero di set restituiti dipende dalle dimensioni delle voci e dalle dimensioni del buffer fornito dal client quando viene chiamata la funzione.

I dati restituiti nel buffer vengono ordinati prima per gruppo e quindi dalle origini all'interno di un gruppo. Le statistiche restituite includono i pacchetti ricevuti, byte ricevuti e pacchetti inoltrati in ogni interfaccia in uscita.

Sintassi

DWORD MgmGetFirstMfeStats(
  [in, out] PDWORD pdwBufferSize,
  [in, out] PBYTE  pbBuffer,
  [in, out] PDWORD pdwNumEntries,
            DWORD  dwFlags
);

Parametri

[in, out] pdwBufferSize

In input , pdwBufferSize è un puntatore a una posizione di memoria di dimensioni DWORD contenente le dimensioni, in byte, di pbBuffer.

Nell'output, se il valore restituito è ERROR_INSUFFICIENT_BUFFER, pdwBufferSize riceve la dimensione minima pbBuffer deve essere per contenere un set di statistiche MFE; in caso contrario, il valore di pdwBufferSize rimane invariato.

[in, out] pbBuffer

In input, il client deve fornire un puntatore a un buffer.

Nell'output pbBuffer contiene uno o più set di statistiche MFE. Ogni set di statistiche MFE è una struttura MIB_IPMCAST_MFE_STATS .

[in, out] pdwNumEntries

In input, il client deve fornire un puntatore a una posizione di memoria di dimensioni DWORD.

Nell'output, pdwNumEntries riceve il numero di set di statistiche MFE contenute in pbBuffer.

dwFlags

Determina la struttura dei dati restituita.

Valore	Significato
MGM_MFE_STATS_0	Includere le statistiche corrispondenti a MIB_IPMCAST_MFE_STATS.
MGM_MFE_STATS_1	Includere le statistiche corrispondenti a MIB_IPMCAST_MFE_STATS_EX.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_CAN_NOT_COMPLETE	Impossibile completare la chiamata a questa funzione.
ERROR_INSUFFICIENT_BUFFER	Il buffer specificato è troppo piccolo per anche un set di statistiche MFE. Il client deve controllare il valore di pdwBufferSize per la dimensione minima del buffer necessaria per recuperare un set di statistiche.
ERROR_MORE_DATA	Sono disponibili altre statistiche MFE.
ERROR_NO_MORE_ITEMS	Non sono disponibili altre statistiche MFE. Sono stati restituiti zero o più set di statistiche MFE; controllare il valore di pdwNumEntries per verificare il numero di set di statistiche restituiti.

Commenti

Questa funzione viene usata per iniziare il recupero sequenziale delle statistiche MFE; usare MgmGetNextMfeStats per continuare il processo di recupero.

In generale, per recuperare le statistiche MFE, chiamare prima MgmGetFirstMfeStats. Chiamare quindi MgmGetNextMfeStats una o più volte, fino a quando non ci sono più MFES da restituire. Ogni chiamata a MgmGetNextMfeStats deve iniziare dopo l'ultima chiamata MFE restituita dalla chiamata precedente a MgmGetNextMfeStats (o la chiamata iniziale a MgmGetFirstMfeStats) A tale scopo, il client specifica l'ultima origine e il gruppo nel buffer restituito da una chiamata precedente.

Le statistiche MFE vengono restituite in una struttura MIB_IPMCAST_MFE_STATS o MIB_IPMCAST_MFE_STATS_EX determinata dal parametro dwFlags .

Nota La dimensione minima del buffer a cui fa riferimento pbBuffer non è fissa; è diverso per ogni set di statistiche MFE. Usare la macro sizeof per determinare le dimensioni di ogni set di statistiche restituite nel buffer.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mgm.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

MIB_IPMCAST_MFE_STATS

MIB_IPMCAST_MFE_STATS_EX

MgmGetMfeStats

MgmGetNextMfeStats

Condividi tramite