MINIPORT_HALT 콜백 함수(ndis.h)

아티클
02/07/2025

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

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

통사론

MINIPORT_HALT MiniportHalt;

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

매개 변수

[in] MiniportAdapterContext

미니포트 드라이버가 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 함수는 역순으로 상호 NdisXxx 함수를 호출해야 MiniportInitializeEx드라이버가 호출됩니다.

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

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

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

드라이버가 작업이 완료되기를 기다려야 하는 경우 MiniportHaltExNdisWaitEvent 함수 또는 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