FILTER_SET_MODULE_OPTIONS 콜백 함수(ndis.h)
FilterSetModuleOptions 함수는 지정된 필터 모듈과 연결된 선택적 서비스 집합을 변경합니다.
구문
FILTER_SET_MODULE_OPTIONS FilterSetModuleOptions;
NDIS_STATUS FilterSetModuleOptions(
[in] NDIS_HANDLE FilterModuleContext
)
{...}
매개 변수
[in] FilterModuleContext
이 요청의 대상인 필터 모듈의 컨텍스트 영역에 대한 핸들입니다. FilterAttach 함수에서 이 컨텍스트 영역을 만들고 초기화한 필터 드라이버입니다.
반환 값
FilterSetModuleOptions는 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
FilterSetModuleOptions 는 필터 모듈의 선택적 서비스 및 리소스를 성공적으로 등록했습니다. |
|
FilterSetModuleOptions에서 필터 모듈에 필요한 리소스를 할당할 수 없습니다. |
|
필터 드라이버의 옵션 등록 시도가 실패했습니다. 일반적으로 이러한 오류 상태는 NdisXxx 함수 또는 커널 모드 지원 루틴에서 전파됩니다. |
설명
FilterSetModuleOptions가 정의된 경우 NDIS는 FilterRestart 함수를 호출하기 전에 FilterSetModuleOptions를 호출하여 필터 모듈을 시작합니다.
필터 드라이버는 드라이버 초기화 중에 NdisFRegisterFilterDriver 함수에 전달하는 NDIS_FILTER_DRIVER_CHARACTERISTICS 구조에서 변경 가능한 필터 모듈 옵션의 기본값을 지정합니다.
런타임에 특정 필터 모듈에 대한 옵션을 변경하려면 필터 드라이버가 NDIS_FILTER_DRIVER_CHARACTERISTICS 구조에서 FilterSetModuleOptions의 진입점을 지정해야 합니다.
변경해야 하는 옵션을 지정하기 위해 FilterSetModuleOptions 는 특성 구조를 정의하고 NdisSetOptionalHandlers 함수를 호출합니다. 필터 드라이버는 다른 스레드에서 NdisSetOptionalHandlers 를 호출해서는 안 됩니다.
FilterSetModuleOptions에서 지정할 수 있는 가능한 특성 구조는 다음과 같습니다.
NDIS_FILTER_PARTIAL_CHARACTERISTICS
NDIS_CLIENT_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS
NDIS_CLIENT_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS
NDIS_PROVIDER_CHIMNEY_OFFLOAD_GENERIC_CHARACTERISTICS
NDIS_PROVIDER_CHIMNEY_OFFLOAD_TCP_CHARACTERISTICS
마지막 4개의 구조에 대한 자세한 내용은 NDIS 6.0 TCP 굴뚝 오프로드 설명서를 참조하세요.
각 특성 구조에 지정된 옵션은 각 필터 모듈에 대해 다를 수 있습니다.
NDIS가 FilterDetach 함수를 호출할 때 필터 드라이버는 FilterSetModuleOptions에서 수행된 모든 작업을 실행 취소해야 합니다.
NDIS는 IRQL = PASSIVE_LEVEL FilterSetModuleOptions 를 호출합니다.
예제
FilterSetModuleOptions 함수를 정의하려면 먼저 정의하는 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버, SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 Code Analysis 오류를 찾는 데 도움이 되며 Windows 운영 체제에 대한 드라이버를 작성하기 위한 요구 사항입니다.예를 들어 " MySetModuleOptions"라는 FilterSetModuleOptions 함수를 정의하려면 이 코드 예제와 같이 FILTER_SET_MODULE_OPTIONS 형식을 사용합니다.
FILTER_SET_MODULE_OPTIONS MySetModuleOptions;
그런 다음 다음과 같이 함수를 구현합니다.
_Use_decl_annotations_
NDIS_STATUS
MySetModuleOptions(
NDIS_HANDLE FilterModuleContext
)
{...}
FILTER_SET_MODULE_OPTIONS 함수 형식은 Ndis.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 FILTER_SET_MODULE_OPTIONS 함수 형식에 적용되는 주석이 사용되도록 합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요.
Use_decl_annotations 대한 자세한 내용은 함수 동작에 주석을 추가하세요.
요구 사항
| 지원되는 최소 클라이언트 | NDIS 6.0 이상에서 지원됩니다. |
| 대상 플랫폼 | Windows |
| 헤더 | ndis.h(Ndis.h 포함) |
| IRQL | PASSIVE_LEVEL |
참고 항목
NDIS_FILTER_DRIVER_CHARACTERISTICS
피드백
다음에 대한 사용자 의견 제출 및 보기