MINIPORT_HALT 콜백 함수(ndis.h)

아티클
08/07/2023

NDIS는 미니포트 드라이버의 MiniportHaltEx 함수를 호출하여 미니포트 어댑터가 제거될 때 리소스를 해제하고 하드웨어를 중지합니다. 이 함수는 미니포트를 중지됨 상태로 전환합니다. 여기서 다른 콜백이 발생할 수 없습니다( MiniportShutdownEx 포함). 미니포트 드라이버 상태에 대한 자세한 내용은 미니포트 어댑터 상태 및 작업을 참조하세요.

참고MINIPORT_HALT 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.

구문

MINIPORT_HALT MiniportHalt;

void MiniportHalt(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] NDIS_HALT_ACTION HaltAction
)
{...}

매개 변수

[in] MiniportAdapterContext

Miniport 드라이버가 MiniportInitializeEx 함수에 할당한 컨텍스트 영역에 대한 핸들입니다. 미니포트 드라이버는 이 컨텍스트 영역을 사용하여 미니포트 어댑터에 대한 상태 정보를 유지 관리합니다.

[in] HaltAction

미니포트 어댑터를 중지하는 이유입니다. 다음 값 중 하나일 수 있습니다.

NdisHaltDeviceDisabled

NDIS는 플러그 앤 플레이(PnP) 제거 메시지에 대한 응답으로 미니포트 어댑터를 중지합니다.

NdisHaltDeviceInstanceDeInitialized

NDIS는 를 호출하는 중간 드라이버에 대한 응답으로 미니포트 어댑터를 중지합니다. NdisIMDeInitializeDeviceInstance 함수입니다.

NdisHaltDevicePoweredDown

시스템이 절전 모드 상태가 되므로 NDIS가 미니포트 어댑터를 중지합니다.

NdisHaltDeviceSurpriseRemoved

미니포트 어댑터가 깜짝 제거되었으며 하드웨어가 없습니다.

NdisHaltDeviceFailed

하드웨어 오류로 인해 미니포트 어댑터가 제거되고 있습니다. NdisMRemoveMiniport 함수라는 미니포트 드라이버 또는 버스 드라이버가 다시 시작 시 NIC에 전원을 공급하지 않았습니다.

NdisHaltDeviceInitializationFailed

MiniportInitializeEx 함수가 성공적으로 완료된 후 알 수 없는 이유로 미니포트 어댑터를 초기화할 수 없습니다.

NdisHaltDeviceStopped

NDIS는 PnP 중지 디바이스 메시지에 대한 응답으로 미니포트 어댑터를 중지합니다.

반환 값

없음

설명

드라이버는 를 호출할 때 MiniportHaltEx 진입점을 지정합니다. NdisMRegisterMiniportDriver 함수.

NDIS는 드라이버의 MiniportInitializeEx 함수가 성공적으로 반환된 후 언제든지 MiniportHaltEx를 호출할 수 있습니다. 드라이버가 물리적 NIC를 제어하는 경우 MiniportHaltEx 는 NIC를 중지해야 합니다. NDIS 중간 드라이버가 를 호출하는 경우 NdisIMDeInitializeDeviceInstance 함수인 NDIS는 드라이버의 가상 디바이스에 대한 MiniportHaltEx 함수를 호출합니다.

MiniportHaltEx 는 디바이스에 대해 MiniportInitializeEx 에 할당된 모든 리소스를 해제해야 합니다. MiniportHaltEx 는 드라이버가 해당 디바이스에 대한 후속 작업에서 할당한 다른 리소스도 해제합니다. 드라이버는 원래 리소스를 할당한 NdisXxx 함수의 상호를 호출해야 합니다. 일반적으로 MiniportHaltEx 함수는 MiniportInitializeEx에서 만든 드라이버를 호출하기 위해 역순으로 상호 NdisXxx 함수를 호출해야 합니다.

NIC가 인터럽트를 생성하는 경우 MiniportHaltEx가 에 호출될 때까지 미니포트 드라이버의 MiniportHaltEx 함수를 드라이버의 MiniportInterrupt 함수에 의해 선점할 수 있습니다. NdisMDeregisterInterruptEx 함수가 반환됩니다. 이러한 드라이버의 MiniportHaltEx 함수는 인터럽트를 사용하지 않도록 설정하고 를 호출해야 합니다.가능한 한 빨리 NdisMDeregisterInterruptEx. 드라이버가 다음까지 인터럽트 계속 받을 수 있습니다. NdisMDeregisterInterruptEx가 반환됩니다. NdisMDeregisterInterruptEx 는 드라이버가 예약된 모든 DPC를 완료할 때까지 반환되지 않습니다(자세한 내용은 MiniportInterruptDPC 함수 참조).

드라이버에 시스템 타이머 큐에 있을 수 있는 타이머 개체와 연결된 NetTimerCallback 함수가 있는 경우 MiniportHaltEx 는 NdisCancelTimerObject 함수를 호출해야 합니다. NdisCancelTimerObject가 실패하면 타이머가 이미 실행되었을 수 있습니다. 이 경우 드라이버는 MiniportHaltEx에서 드라이버가 반환되기 전에 타이머 함수가 완료되기를 기다려야 합니다.

미해결 OID 요청이 있거나 요청을 보내는 경우 NDIS는 MiniportHaltEx 를 호출하지 않습니다. NDIS는 NDIS가 MiniportHaltEx를 호출한 후 영향을 받는 디바이스에 대한 추가 요청을 제출하지 않습니다.

드라이버가 작업이 완료되기를 기다려야 하는 경우 MiniportHaltEx 는 NdisWaitEvent 함수 또는 NdisMSleep 함수를 사용할 수 있습니다.

NDIS는 IRQL = PASSIVE_LEVEL MiniportHaltEx 를 호출합니다.

예

MiniportHaltEx 함수를 정의하려면 먼저 정의 중인 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버에 대한 코드 분석, SDV( 정적 드라이버 검증 도구 ) 및 기타 확인 도구에서 오류를 찾는 데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 " MyHaltEx"라는 MiniportHaltEx 함수를 정의하려면 다음 코드 예제와 같이 MINIPORT_HALT 형식을 사용합니다.

MINIPORT_HALT MyHaltEx;

그런 다음 다음과 같이 함수를 구현합니다.

_Use_decl_annotations_
VOID
 MyHaltEx(
    NDIS_HANDLE  MiniportAdapterContext,
    NDIS_HALT_ACTION  HaltAction
    )
  {...}

MINIPORT_HALT 함수 형식은 Ndis.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 MINIPORT_HALT 함수 형식에 적용되는 주석이 사용되도록 합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요.

Use_decl_annotations 대한 자세한 내용은 함수 동작에 주석을 추가를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	Windows
헤더	ndis.h(Ndis.h 포함)
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	WlanAssociation, WlanConnectionRoaming, WlanDisassociation, WlanTimedAssociation, WlanTimedConnectionRoaming, WlanTimedConnectRequest, WlanTimedLinkQuality, WlanTimedScan