PMGM_CREATION_ALERT_CALLBACK 콜백 함수(mgm.h)

PMGM_CREATION_ALERT_CALLBACK 콜백은 라우팅 프로토콜에 대한 호출입니다. 이 호출은 새 원본의 멀티캐스트 패킷을 전달해야 하는 라우팅 프로토콜이 소유한 인터페이스의 하위 집합을 결정합니다.

새 원본에서 전송되거나 새 그룹으로 향하는 패킷이 인터페이스에 도착하면 멀티캐스트 그룹 관리자는 새 MFE를 만듭니다. 그런 다음 멀티캐스트 그룹 관리자는 이 새 MFE에 나가는 인터페이스가 있는 라우팅 프로토콜에 이 콜백을 호출합니다. 라우팅 프로토콜은 특정 인터페이스에서 원본에서 그룹으로의 데이터 전달을 사용하지 않도록 선택할 수 있습니다.

구문

PMGM_CREATION_ALERT_CALLBACK PmgmCreationAlertCallback;

DWORD PmgmCreationAlertCallback(
  [in]      DWORD dwSourceAddr,
  [in]      DWORD dwSourceMask,
  [in]      DWORD dwGroupAddr,
  [in]      DWORD dwGroupMask,
  [in]      DWORD dwInIfIndex,
  [in]      DWORD dwInIfNextHopAddr,
  [in]      DWORD dwIfCount,
  [in, out] PMGM_IF_ENTRY pmieOutIfList
)
{...}

매개 변수

[in] dwSourceAddr

멀티캐스트 데이터를 받은 원본 주소를 지정합니다. 0은 모든 원본(그룹에 대한 와일드카드 수신기)에서 데이터를 수신했음을 나타냅니다. 그렇지 않으면 dwSourceAddr 값은 원본 또는 원본 네트워크의 IP 주소입니다.

원본 주소 범위를 지정하기 위해 멀티캐스트 그룹 관리자는 dwSourceAddr를 사용하여 원본 네트워크를 지정하고 dwSourceMask를 사용하여 서브넷 마스크를 지정합니다.

[in] dwSourceMask

dwSourceAddr에 해당하는 서브넷 마스크를 지정합니다. dwSourceAddr 및 dwSourceMask 매개 변수는 멀티캐스트 데이터를 받을 원본 범위를 정의하는 데 함께 사용됩니다.

멀티캐스트 그룹 관리자는 dwSourceAddr (와일드카드 수신기)에 0을 지정한 경우 이 매개 변수에 대해 0을 지정합니다.

[in] dwGroupAddr

데이터를 대상으로 하는 멀티캐스트 그룹을 지정합니다. 0은 모든 그룹이 수신됨(와일드카드 수신기)을 나타냅니다. 그렇지 않으면 dwGroupAddr 값은 그룹의 IP 주소입니다.

그룹 주소 범위를 지정하기 위해 멀티캐스트 그룹 관리자는 dwGroupAddr을 사용하여 그룹 주소를 지정하고 dwGroupMask를 사용하여 서브넷 마스크를 지정합니다.

[in] dwGroupMask

dwGroupAddr에 해당하는 서브넷 마스크를 지정합니다. dwGroupAddr 및 dwGroupMask 매개 변수는 멀티캐스트 그룹의 범위를 정의하는 데 함께 사용됩니다.

멀티캐스트 그룹 관리자는 dwGroupAddr (와일드카드 수신기)에도 0을 지정한 경우 이 매개 변수에 대해 0을 지정합니다.

[in] dwInIfIndex

원본의 멀티캐스트 데이터가 도착할 인터페이스를 지정합니다.

[in] dwInIfNextHopAddr

dwIfIndex에서 지정한 인덱스에 해당하는 다음 홉의 주소를 지정합니다. dwIfIndex 및 dwIfNextHopIPAddr 매개 변수는 지점 간 인터페이스에서 다음 홉을 고유하게 식별합니다. 지점 및 다중 지점 인터페이스는 하나의 인터페이스가 여러 네트워크에 연결되는 연결입니다. 지점 및 다중 지점 인터페이스의 예로는 NBMA(비 브로드캐스트 다중 액세스) 인터페이스 및 모든 전화 접속 클라이언트가 연결하는 내부 인터페이스가 있습니다.

dwIfIndex 값으로만 식별되는 브로드캐스트 인터페이스(예: 이더넷 인터페이스) 또는 지점 및 지점 인터페이스의 경우 0을 지정합니다.

[in] dwIfCount

pmieOutIfList가 가리키는 버퍼의 인터페이스 수를 지정합니다.

[in, out] pmieOutIfList

입력 시 데이터를 전달할 프로토콜이 소유한 인터페이스 집합을 포함하는 버퍼에 대한 포인터입니다.

출력 시 클라이언트는 해당 MGM_IF_ENTRY 구조체의 bIsEnabled 멤버를 FALSE로 설정하여 해당 인터페이스에서 전달되지 않도록 할 수 있습니다. 전달을 방지하기 위해 클라이언트가 필요하지 않을 수 있습니다. 이러한 클라이언트는 bIsEnabled의 기본값을 수락합니다.

반환 값

RRAS는 애플리케이션이 특정 값을 반환할 것으로 예상하지 않습니다. 반환된 모든 값은 RRAS에서 무시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	mgm.h

추가 정보

MGM_IF_ENTRY