Condividi tramite


Funzione MgmGetFirstMfeStats (mgm.h)

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