NdisMSetMiniportAttributes 함수(ndis.h)

아티클
08/07/2023

미니포트 드라이버는 MiniportInitializeEx 함수에서 NdisMSetMiniportAttributes 함수를 호출하여 미니포트 어댑터의 컨텍스트 영역을 NDIS로 식별하고 미니포트 어댑터에 대한 정보를 NDIS에 제공해야 합니다.

구문

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

매개 변수

NdisMiniportHandle

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

[in] MiniportAttributes

에 대한 포인터 드라이버 할당 특성 구조를 포함하는 NDIS_MINIPORT_ADAPTER_ATTRIBUTES 공용 구조체입니다. 구조체는 MiniportAdapterHandle이 지정하는 미니포트 어댑터 instance 특성을 정의합니다.

반환 값

NdisMSetMiniportAttributes는 다음 상태 값 중 하나를 반환합니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes 는 미니포트 어댑터 특성을 성공적으로 등록했습니다.
NDIS_STATUS_BAD_VERSION	NDIS가 MiniportAttributes 의 헤더 멤버에 지정된 구조체의 Revision 멤버에 지정된 버전을 지원하지 않음을 나타냅니다.

설명

미니포트 드라이버는 MiniportInitializeEx 함수에서 NdisMSetMiniportAttributes를 호출해야 드라이버가 NdisMSetMiniportAttributes에 제공된 정보에 따라 다른 NdisXxx 함수를 호출합니다.

The NDIS_MINIPORT_ADAPTER_ATTRIBUTES 공용 구조체는 다양한 특성 구조에 대한 자리 표시자입니다. 미니포트 드라이버는 서로 다른 특성 구조로 NdisMSetMiniportAttributes를 여러 번 호출합니다. 미니포트 드라이버는 초기화된 를 제공해야 합니다.MiniportInitializeEx에서 구조체를 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES. 미니포트 드라이버는 이러한 특성에 의존하거나 하드웨어 리소스를 클레임하는 다른 NdisXxx 함수를 호출하기 전에 이러한 등록 특성을 제공해야 합니다.

드라이버는 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 구조의 NDIS에 MiniportAdapterContext 멤버를 제공합니다. MiniportAdapterContext 멤버는 NDIS가 드라이버의 MiniportXxx 함수에 입력 매개 변수로 전달하는 호출자 제공 컨텍스트 영역을 식별합니다. 이 컨텍스트 영역에는 미니포트 어댑터 관련 상태 정보가 포함됩니다.

미니포트 드라이버는 에서 특성을 설정해야 합니다. NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 구조에서 등록 특성을 설정한 후 추가 특성을 설정하기 전에 구조체를 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

미니포트 드라이버는 MiniportAddDevice 함수에서 NdisMSetMiniportAttributes를 호출할 수도 있습니다. 이 경우 NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES 구조체를 사용하여 컨텍스트 영역을 지정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	유니버설
헤더	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)