MINIPORT_SHUTDOWN 콜백 함수(ndis.h)
NDIS는 시스템이 종료되면 미니포트 드라이버의 MiniportShutdownEx 함수를 호출합니다. 이 함수는 미니포트를 종료 상태로 전환합니다. 여기서 다른 콜백이 발생할 수 없습니다(MiniportHaltEx포함). 미니포트 드라이버 상태에 대한 자세한 내용은 미니포트 어댑터 상태 및 작업참조하세요.
통사론
MINIPORT_SHUTDOWN MiniportShutdown;
void MiniportShutdown(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] NDIS_SHUTDOWN_ACTION ShutdownAction
)
{...}
매개 변수
[in] MiniportAdapterContext
미니포트 드라이버가 MiniportInitializeEx에 할당한 컨텍스트 영역에 대한 핸들이. 드라이버는 이 컨텍스트 영역을 사용하여 미니포트 어댑터에 대한 상태 정보를 유지 관리합니다.
[in] ShutdownAction
NDIS가 종료 함수를 호출한 이유입니다. 다음 값은 유효합니다.
NdisShutdownPowerOff
시스템이 종료되어 MiniportShutdownEx라는 NDIS가 나타냅니다.
NdisShutdownBugCheck
시스템 오류로 인해 MiniportShutdownEx NDIS가 호출되었음을 나타냅니다.
반환 값
없음
발언
드라이버는 다음을 호출할 때 MiniportShutdownEx 진입점을 지정합니다. NdisMRegisterMiniportDriver 함수입니다.
MiniportShutdownEx 미니포트 어댑터를 알려진 초기 상태로 복원합니다(미니포트 어댑터에 대한 미니포트 드라이버의 MiniportInitializeEx 함수라고 하는 NDIS 이전의 상태). 이렇게 하면 복구할 수 없는 시스템 오류를 포함하여 어떤 이유로든 시스템 종료 후 컴퓨터를 다시 시작할 때 미니포트 어댑터가 알려진 상태이고 다시 초기화할 준비가 되었는지 확인합니다.
MiniportShutdownEx NdisMGetBusData 또는NdisMSetBusData 함수를 호출하여 I/O 포트, 메모리 매핑 디바이스 I/O 공간 또는 버스별 구성 공간을 읽거나 쓸 수 있으며, DMA 엔진을 사용하지 않도록 설정하거나, 인터럽트를 사용하지 않도록 설정하거나 하드웨어를 알려진 상태로 다시 설정하여 하드웨어를 안전하게 다시 시작할 수 있습니다.
복구할 수 없는 오류로 인해 NDIS가 MiniportShutdownEx 호출하는 경우 ShutdownAction 매개 변수는 NdisShutdownBugCheck 설정되고 MiniportShutdownEx 높은 IRQL에서 실행됩니다. 이 경우 미니포트 드라이버는 IRQL에서 호출할 수 있는 함수를 제외하고 NdisXxx 함수를 호출해서는 안 됩니다.
NDIS가 사용자가 시작한 종료로 인해 MiniportShutdownEx 호출하는 경우 MiniportShutdownEx IRQL = PASSIVE_LEVEL 실행되고 미니포트 드라이버는 다른 NdisXxx 함수를 호출할 수 있습니다.
복구할 수 없는 오류로 인해 NDIS가 MiniportShutdownEx 호출하는 경우 ShutdownAction 매개 변수는 NdisShutdownBugCheck 설정되고 MiniportShutdownEx 높은 IRQL에서 실행됩니다. 이 경우 미니포트 드라이버는 IRQL에서 호출할 수 있는 함수를 제외하고 NdisXxx 함수를 호출해서는 안 됩니다. NDIS 6.30 미니포트부터 NDIS는 미니포트가 어댑터 등록 특성에 NDIS_MINIPORT_ATTRIBUTES_REGISTER_BUGCHECK_CALLBACK 플래그를 제공하지 않는 한 BugCheck 중에 MiniportShutdownEx 호출하지 않습니다.
ShutdownAction 값이 NdisShutdownPowerOff 경우 미니포트 드라이버는 필요에 따라 리소스를 해제할 수 있습니다. 그러나 시스템 종료로 인해 필요하지 않으므로 필수도 권장되지도 않습니다.
ShutdownAction 값이 NdisShutdownBugCheck 경우 미니포트 드라이버는 리소스를 해제해서는 안 됩니다.
예제
MiniportShutdownEx 함수를 정의하려면 먼저 정의하려는 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.예를 들어 "MyShutdownEx"라는 MiniportShutdownEx 함수를 정의하려면 다음 코드 예제와 같이 MINIPORT_SHUTDOWN 형식을 사용합니다.
MINIPORT_SHUTDOWN MyShutdownEx;
그런 다음 다음과 같이 함수를 구현합니다.
_Use_decl_annotations_
VOID
MyShutdownEx(
NDIS_HANDLE MiniportAdapterContext,
NDIS_SHUTDOWN_ACTION ShutdownAction
)
{...}
MINIPORT_SHUTDOWN 함수 형식은 Ndis.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 MINIPORT_SHUTDOWN 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버함수 역할 형식을 사용하여 함수 선언을 참조하세요.
Use_decl_annotations대한 자세한 내용은 함수 동작 주석참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.0 이상에서 지원됩니다. |
| 대상 플랫폼 | Windows |
| 헤더 | ndis.h(Ndis.h 포함) |
| IRQL | 설명 섹션 참조 |