MgmGetFirstMfeStats 함수(mgm.h)
MgmGetFirstMfeStats 함수는 MFE 목록의 시작 부분에서 시작하는 MFE 통계를 검색합니다. 함수는 0개, 1개 이상의 MFE 통계 집합을 검색할 수 있습니다. 반환되는 집합 수는 함수가 호출되는 경우 항목의 크기와 클라이언트에서 제공하는 버퍼의 크기에 따라 달라집니다.
버퍼에 반환된 데이터는 먼저 그룹별로 정렬된 다음 그룹 내의 원본에 의해 정렬됩니다. 반환되는 통계에는 수신된 패킷, 수신된 바이트 및 나가는 각 인터페이스에서 전달된 패킷이 포함됩니다.
구문
DWORD MgmGetFirstMfeStats(
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
[in, out] PDWORD pdwNumEntries,
DWORD dwFlags
);
매개 변수
[in, out] pdwBufferSize
입력 시 pdwBufferSize는 pbBuffer의 크기(바이트)를 포함하는 DWORD 크기의 메모리 위치에 대한 포인터입니다.
출력에서 반환 값이 ERROR_INSUFFICIENT_BUFFER 경우 pdwBufferSize 는 MFE 통계 집합을 보유해야 하는 최소 크기 pbBuffer 를 받습니다. 그렇지 않으면 pdwBufferSize 값이 변경되지 않은 상태로 유지됩니다.
[in, out] pbBuffer
입력 시 클라이언트는 버퍼에 대한 포인터를 제공해야 합니다.
출력에서 pbBuffer 에는 하나 이상의 MFE 통계 집합이 포함됩니다. 각 MFE 통계 집합은 MIB_IPMCAST_MFE_STATS 구조체입니다.
[in, out] pdwNumEntries
입력 시 클라이언트는 DWORD 크기의 메모리 위치에 대한 포인터를 제공해야 합니다.
출력에서 pdwNumEntries 는 pbBuffer에 포함된 MFE 통계 집합의 수를 받습니다.
dwFlags
반환된 데이터 구조를 결정합니다.
| 값 | 의미 |
|---|---|
|
MIB_IPMCAST_MFE_STATS 해당하는 통계를 포함합니다. |
|
MIB_IPMCAST_MFE_STATS_EX 해당하는 통계를 포함합니다. |
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
이 함수에 대한 호출을 완료할 수 없습니다. |
|
지정된 버퍼가 너무 작아서 MFE 통계 집합이 하나도 없습니다. 클라이언트는 하나의 통계 집합을 검색하는 데 필요한 최소 버퍼 크기에 대해 pdwBufferSize 값을 검사 합니다. |
|
더 많은 MFE 통계를 사용할 수 있습니다. |
|
더 이상 MFE 통계를 사용할 수 없습니다. 0개 이상의 MFE 통계 집합이 반환되었습니다. pdwNumEntries 값을 검사 반환된 통계 집합 수를 확인합니다. |
설명
이 함수는 MFE 통계의 순차적 검색을 시작하는 데 사용됩니다. MgmGetNextMfeStats를 사용하여 검색 프로세스를 계속합니다.
일반적으로 MFE 통계를 검색하려면 먼저 MgmGetFirstMfeStats를 호출합니다. 그런 다음, 더 이상 반환할 MFE가 없을 때까지 MgmGetNextMfeStats 를 한 번 이상 호출합니다. MgmGetNextMfeStats에 대한 각 호출은 MgmGetNextMfeStats(또는 MgmGetFirstMfeStats에 대한 초기 호출)에 대한 이전 호출에서 반환된 마지막 MFE 후에 시작되어야 합니다. 이렇게 하려면 클라이언트는 이전 호출에서 반환된 버퍼의 마지막 원본과 그룹을 지정합니다.
MFE 통계는 dwFlags 매개 변수에 의해 결정된 MIB_IPMCAST_MFE_STATS 또는 MIB_IPMCAST_MFE_STATS_EX 구조로 반환됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mgm.h |
| 라이브러리 | Rtm.lib |
| DLL | Rtm.dll |