NdisMInvalidateConfigBlock 함수(ndis.h)

  • 아티클

미니포트 드라이버는 NdisMInvalidateConfigBlock 함수를 호출하여 하나 이상의 VF(가상 함수) 구성 블록에 대한 데이터가 변경되었음을 NDIS에 알립니다.

참고NdisMInvalidateConfigBlock 은 네트워크 어댑터의 PCIe PF(물리적 함수)에 대한 미니포트 드라이버에서만 호출해야 합니다.
 

구문

void NdisMInvalidateConfigBlock(
  [in] NDIS_HANDLE            NdisMiniportHandle,
  [in] NDIS_SRIOV_FUNCTION_ID VFId,
  [in] ULONGLONG              BlockMask
);

매개 변수

[in] NdisMiniportHandle

NDIS가 MiniportInitializeEx의 MiniportAdapterHandle 매개 변수에 전달한 네트워크 어댑터 핸들입니다.

[in] VFId

디바이스 위치가 반환되는 VF의 식별자입니다.

[in] BlockMask

처음 64개의 VF 구성 블록에 대한 비트 마스크를 지정하는 ULONGLONG 값입니다. 비트 마스크의 각 비트는 VF 구성 블록에 해당합니다. 비트가 1로 설정된 경우 해당 VF 구성 블록과 연결된 데이터가 변경됩니다.

반환 값

없음

설명

VF 구성 블록은 PF와 VF 미니포트 드라이버 간의 백채널 통신에 사용됩니다. IHV는 디바이스에 대해 하나 이상의 VF 구성 블록을 정의할 수 있습니다. 각 VF 구성 블록에는 IHV 정의 형식, 길이 및 블록 ID가 있습니다.

참고 각 VF 구성 블록의 데이터는 PF 및 VF 미니포트 드라이버에서만 사용됩니다.
 
VF 구성 데이터는 다음 드라이버 간에 교환됩니다.
  • 게스트 운영 체제에서 실행되는 VF 드라이버입니다. 이 운영 체제는 Hyper-V 자식 파티션 내에서 실행됩니다.
  • 관리 운영 체제에서 실행되는 PF 드라이버입니다.

    이 운영 체제는 Hyper-V 부모 파티션 내에서 실행됩니다.

잘못된 VF 구성 데이터의 알림을 처리하기 위해 NDIS 및 미니포트 드라이버는 다음 단계를 수행합니다.
  1. 게스트 운영 체제에서 NDIS는 IOCTL_VPCI_INVALIDATE_BLOCK 요청의 I/O 제어 요청을 실행합니다. 이 IOCTL이 완료되면 NDIS는 VF 구성 데이터가 변경되었다는 알림을 받습니다.
  2. 관리 운영 체제에서 다음 단계가 수행됩니다.
    1. PF 미니포트 드라이버는 NdisMInvalidateConfigBlock 함수를 호출하여 VF 구성 데이터가 변경되었으며 더 이상 유효하지 않음을 NDIS에 알립니다.
    2. NDIS는 관리 운영 체제에서 실행되는 가상화 스택에 VF 구성 블록 데이터 변경에 대한 신호를 보냅니다. 가상화 스택은 BlockMask 매개 변수 데이터를 캐시합니다.
      참고 PF 미니포트 드라이버가 NdisMInvalidateConfigBlock을 호출할 때마다 가상화 스택은 BlockMask 매개 변수 데이터를 캐시의 현재 값과 함께 RS합니다.
       
    3. 가상화 스택은 게스트 운영 체제에서 실행되는 VPCI(가상 PCI) 드라이버에 VF 구성 데이터의 무효화에 대해 알 수 있습니다. 가상화 스택은 캐시된 BlockMask 매개 변수 데이터를 VPCI 드라이버로 보냅니다.
  3. 게스트 운영 체제에서 다음 단계가 수행됩니다.
    1. VPCI 드라이버는 캐시된 BlockMask 매개 변수 데이터를 IOCTL_VPCI_INVALIDATE_BLOCK 요청과 연결된 VPCI_INVALIDATE_BLOCK_OUTPUT 구조체의 BlockMask 멤버에 저장합니다.
    2. VPCI 드라이버가 IOCTL_VPCI_INVALIDATE_BLOCK 요청을 성공적으로 완료합니다. 이 경우 NDIS는 VF 미니포트 드라이버에 OID_SRIOV_VF_INVALIDATE_CONFIG_BLOCK OID 메서드 요청을 발급합니다. NDIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO 요청은 OID 요청에 전달됩니다. 이 구조체에는 캐시된 BlockMask 매개 변수 데이터가 포함됩니다.

      또한 NDIS는 VF 구성 데이터 변경에 대한 연속 알림을 처리하기 위한 또 다른 IOCTL_VPCI_INVALIDATE_BLOCK 요청을 발행합니다.

    3. VF 드라이버가 OID_SRIOV_VF_INVALIDATE_CONFIG_BLOCK 요청을 처리하면 지정된 VF 구성 블록에서 데이터를 읽습니다.
단일 루트 I/O 가상화(SR-IOV) 인터페이스 내의 백채널 통신에 대한 자세한 내용은 SR-IOV PF/VF 백채널 통신을 참조하세요.

SR-IOV 인터페이스에 대한 자세한 내용은 SR-IOV(단일 루트 I/O 가상화) 개요를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 6.30 이상에서는 지원되지 않습니다.
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 유니버설
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL <= DISPATCH_LEVEL

추가 정보

IOCTL_VPCI_INVALIDATE_BLOCK

NDIS_SRIOV_VF_INVALIDATE_CONFIG_BLOCK_INFO

OID_SRIOV_READ_VF_CONFIG_SPACE

VPCI_INVALIDATE_BLOCK_OUTPUT