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가 버스에 보고한 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