NdisMSetMiniportAttributes 함수(ndis.h)

아티클
04/21/2022
읽는 데 3분 걸림

미니포트 드라이버는 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 이 지정하는 미니포트 어댑터 인스턴스의 특성을 정의합니다.

반환 값

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

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

설명

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

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)