다음을 통해 공유


NdisMConfigMSIXTableEntry 함수(ndis.h)

NdisMConfigMSIXTableEntry 함수는 디바이스 할당 MSI-X 메시지에 대한 MSI-X 테이블 항목에 대한 구성 작업을 수행합니다.

통사론

NDIS_STATUS NdisMConfigMSIXTableEntry(
  [in] NDIS_HANDLE                  NdisMiniportHandle,
  [in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);

매개 변수

[in] NdisMiniportHandle

NDIS에서 제공하는 NDIS 미니포트 어댑터 핸들 MiniportInitializeEx 함수입니다.

[in] MSIXConfigParameters

호출자가 할당한 포인터 요청된 구성 작업을 정의하고 해당 특정 작업에 필요한 매개 변수를 지정하는 NDIS_MSIX_CONFIG_PARAMETERS 구조체입니다.

반환 값

NdisMConfigMSIXTableEntry 기본 PCI 버스 드라이버 또는 다음 상태 값 중 하나에서 적절한 오류 코드를 반환합니다.

반환 코드 묘사
NDIS_STATUS_SUCCESS
MSI-X 테이블 항목이 다시 구성되었습니다.
NDIS_STATUS_INVALID_PARAMETER
NdisMConfigMSIXTableEntry 하나 이상의 멤버가 실패했습니다. NDIS_MSIX_CONFIG_PARAMETERS 구조가 잘못되었습니다.

발언

MSI-X 지원하는 NDIS 미니포트 드라이버는 NdisMConfigMSIXTableEntry 함수를 호출하여 MSI-X 테이블 항목을 디바이스 할당 MSI-X 메시지에 마스크, 마스크 해제 또는 매핑합니다. RSS를 지원하는 미니포트 드라이버는 NdisMConfigMSIXTableEntry 사용하여 런타임에 MSI-X 테이블 항목의 CPU 선호도를 변경합니다.

NdisMConfigMSIXTableEntry GUID_MSIX_TABLE_CONFIG_INTERFACE 쿼리입니다. 미니포트 드라이버는 NDIS가 MiniportInitializeEx 함수를 호출하고 드라이버가 MiniportHaltEx 함수에서 반환되기 전에 NdisMConfigMSIXTableEntry 호출할 수 있습니다.

미니포트 드라이버는 디바이스에 각 RSS 프로세서에 대해 하나 이상의 MSI-X 메시지를 포함하도록 MSI-X 인터럽트 리소스의 CPU 선호도를 설정할 수 있습니다. PCI 버스 드라이버는 처음에 n MSI-X 테이블 항목(여기서 n은 NIC hadware가 버스에 보고한 MSI-X 테이블 항목 수)을 수정된 리소스의 첫 번째 n MSI-X 메시지에 매핑합니다. NDIS가 MiniportInitializeEx호출한 후 미니포트 드라이버가 특정 MSI-X 테이블 항목의 대상 프로세서를 변경하면 드라이버는 NdisMConfigMSIXTableEntry 호출하여 해당 테이블 항목을 이미 선호도가 원하는 프로세서로 설정된 MSI-X 메시지에 매핑합니다.

NdisMSIXTableConfigSetTableEntry 작업의 경우 NdisMConfigMSIXTableEntry 호출자는 IRQL <= DISPATCH_LEVEL 실행해야 합니다.

NdisMSIXTableConfigMaskTableEntry 또는 NdisMSIXTableConfigUnmaskTableEntry 작업의 경우 NdisMConfigMSIXTableEntry 호출자는 모든 IRQL에서 실행할 수 있습니다.

요구 사항

요구
지원되는 최소 클라이언트 NDIS 6.1 이상에서 지원됩니다.
대상 플랫폼 보편적
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL 설명 섹션 참조

참고 항목

MiniportHaltEx

MiniportInitializeEx

NDIS_MSIX_CONFIG_PARAMETERS