mgmGetMfeStats 函式 (mgm.h)
MgmGetMfeStats 函式會擷取特定 MFE 的統計資料。 傳回的統計資料包括接收的封包、接收的位元組,以及每個傳出介面上轉送的封包。
語法
DWORD MgmGetMfeStats(
[in] PMIB_IPMCAST_MFE pimm,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
DWORD dwFlags
);
參數
[in] pimm
指定要擷取統計資料之 MFE 的 MIB_IPMCAST_MFE 結構的指標。 要傳回的資訊是由MIB_IPMCAST_MFE結構的dwSource和dwGroup成員表示。
[in, out] pdwBufferSize
在輸入時, pdwBufferSize 是 DWORD大小的記憶體位置指標,其中包含 pbBuffer所指向緩衝區的大小,以位元組為單位。
輸出時,如果傳回值ERROR_INSUFFICIENT_BUFFER, pdwBufferSize 會收到 pbBuffer 所指向緩衝區的大小下限,必須保留 MFE 統計資料集;否則 pdwBufferSize 的值會保持不變。
[in, out] pbBuffer
在輸入時,用戶端必須提供緩衝區的指標。
在輸出中, pbBuffer 包含指定的 MFE 統計資料集。
dwFlags
決定傳回的資料結構。
值 | 意義 |
---|---|
|
包含對應至 MIB_IPMCAST_MFE_STATS的統計資料。 |
|
包含對應至 MIB_IPMCAST_MFE_STATS_EX的統計資料。 |
傳回值
如果函式成功,傳回值會NO_ERROR。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
無法完成此函式的呼叫。 |
|
即使一個 MFE 的統計資料,指定的緩衝區太小。 用戶端應該檢查 pdwBufferSize 的值,以瞭解擷取一個 MFE 統計資料所需的最小緩衝區大小。 |
|
找不到指定的 MFE。 |
備註
MFE 統計資料會在dwFlags參數所決定的MIB_IPMCAST_MFE_STATS或MIB_IPMCAST_MFE_STATS_EX結構中傳回。
需求
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | mgm.h |
程式庫 | Rtm.lib |
Dll | Rtm.dll |