NDIS는 필터 드라이버의 FilterAttach 함수를 호출하여 필터 모듈의 데이터 구조를 할당하고 초기화합니다.
참고FILTER_ATTACH 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.
통사론
FILTER_ATTACH FilterAttach;
NDIS_STATUS FilterAttach(
[in] NDIS_HANDLE NdisFilterHandle,
[in] NDIS_HANDLE FilterDriverContext,
[in] PNDIS_FILTER_ATTACH_PARAMETERS AttachParameters
)
{...}
매개 변수
[in] NdisFilterHandle
필터 모듈을 식별하는 NDIS 핸들입니다. 필터 드라이버는 이 핸들을 저장해야 합니다. 이 핸들은 NdisFXxx 함수에 대한 후속 호출에 필요합니다.
[in] FilterDriverContext
드라이버가 전달한 핸들입니다. 드라이버 컨텍스트 영역을 식별하는 NdisFRegisterFilterDriver 함수입니다.
[in] AttachParameters
에 대한 포인터 필터 모듈의 초기화 매개 변수를 정의하는 NDIS_FILTER_ATTACH_PARAMETERS 구조체입니다.
반환 값
FilterAttach 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
|
FilterAttach 이 필터 모듈에 대한 데이터 구조를 성공적으로 할당하고 초기화했습니다. |
|
FilterAttach 리소스가 부족하여 실패했습니다. |
|
FilterAttach 이전 값이 적용되지 않으면 NDIS_STATUS_FAILURE 반환합니다. 필터 드라이버는 실패 이유를 지정하는 매개 변수와 함께 NdisWriteEventLogEntry 함수를 호출해야 합니다. |
발언
FilterAttach 필수 함수입니다. 지정된 필터 모듈이 분리된 상태일 때 NDIS는 필터 드라이버의 FilterAttach 함수를 호출합니다. NDIS는 FilterSetOptions 함수가 반환된 후 언제든지 FilterAttach 호출할 수 있습니다.
FilterAttach실행이 시작되면 필터 모듈은 연결 상태로 들어갑니다.
필터 드라이버는 불필요한 OID 쿼리를 실행하지 않아야 합니다. 대신 다음의 정보를 사용합니다. NDIS_FILTER_ATTACH_PARAMETERS사용 가능한 경우 기본 드라이버에 대한 정보를 가져옵니다.
필터 드라이버는 NDIS가 FilterAttach 호출할 때 다음 작업을 수행합니다.
- 필터 모듈에 대한 컨텍스트 영역을 만들고 버퍼 풀 및 기타 리소스를 할당합니다.
- NDIS가 FilterAttach전달한 NdisFilterHandle 함께 NdisFSetAttributes 함수를 호출합니다. NdisFSetAttributes의 FilterModuleContext 매개 변수는 이 필터 모듈에 대한 필터 드라이버의 컨텍스트 영역을 지정합니다. NDIS는 필터 드라이버의 FilterXxx 함수에 이 컨텍스트 영역을 전달합니다.
- 필요에 따라 레지스트리에서 구성 매개 변수를 읽습니다.
- 이전 작업이 성공적으로 완료되면 필터 모듈이 일시 중지된 상태가 됩니다.
- 이전 작업이 실패한 경우 필터 드라이버는 FilterAttach 함수에 할당된 리소스를 해제하고 필터 모듈을 분리된 상태로 반환해야 합니다.
- NDIS_STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다.
NDIS는 필터 드라이버의 FilterDetach 함수를 호출하여 필터 모듈과 연결된 모든 리소스를 해제하고 필터 모듈을 분리된 상태로 반환합니다.
NDIS는 IRQL = PASSIVE_LEVEL FilterAttach 호출합니다.
예제
FilterAttach 함수를 정의하려면 먼저 정의하려는 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.예를 들어 "MyAttach"라는 FilterAttach 함수를 정의하려면 다음 코드 예제와 같이 FILTER_ATTACH 형식을 사용합니다.
FILTER_ATTACH MyAttach;
그런 다음 다음과 같이 함수를 구현합니다.
_Use_decl_annotations_
NDIS_STATUS
MyAttach(
NDIS_HANDLE NdisFilterHandle,
NDIS_HANDLE FilterDriverContext,
PNDIS_FILTER_ATTACH_PARAMETERS AttachParameters
)
{...}
FILTER_ATTACH 함수 형식은 Ndis.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 FILTER_ATTACH 함수 형식에 적용되는 주석이 사용되는지 확인합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버함수 역할 형식을 사용하여 함수 선언을 참조하세요.
Use_decl_annotations대한 자세한 내용은 함수 동작 주석참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.0 이상에서 지원됩니다. |
| 대상 플랫폼 | Windows |
| 헤더 | ndis.h(Ndis.h 포함) |
| IRQL | PASSIVE_LEVEL |