PROTOCOL_OPEN_ADAPTER_COMPLETE_EX 콜백 함수(ndis.h)
NDIS는 프로토콜 드라이버의 ProtocolOpenAdapterCompleteEx 함수를 호출하여 NdisOpenAdapterEx 함수가 NDIS_STATUS_PENDING 반환하는 열린 어댑터 작업을 완료합니다.
통사론
PROTOCOL_OPEN_ADAPTER_COMPLETE_EX ProtocolOpenAdapterCompleteEx;
void ProtocolOpenAdapterCompleteEx(
[in] NDIS_HANDLE ProtocolBindingContext,
[in] NDIS_STATUS Status
)
{...}
매개 변수
[in] ProtocolBindingContext
프로토콜 드라이버에서 할당한 컨텍스트 영역에 대한 핸들입니다. 프로토콜 드라이버는 이 컨텍스트 영역에서 바인딩별 컨텍스트 정보를 유지 관리합니다. 드라이버가 NdisOpenAdapterEx호출할 때 드라이버가 NDIS에 이 핸들을 제공했습니다.
[in] Status
기본 미니포트 드라이버에 대한 열기 작업의 최종 상태입니다. 이 상태 값은 바인딩이 설정되었거나 기본 드라이버가 결정하는 오류 상태일 경우 NDIS_STATUS_SUCCESS.
반환 값
없음
발언
ProtocolOpenAdapterCompleteEx 함수가 필요합니다. 프로토콜 드라이버는 ProtocolBindAdapterEx 함수에서 NdisOpenAdapterEx 함수를 호출합니다. NDIS는 보류 중인 열기 작업이 완료된 후 드라이버의 ProtocolOpenAdapterCompleteEx 함수를 호출합니다.
ProtocolBindAdapterEx NDIS가 protocolOpenAdapterCompleteEx 호출하기를 기다리는 경우 이 함수는 단순히 상태를 저장하고 호출되었음을 나타낼 수 있습니다(예: ProtocolBindingContext 컨텍스트 영역을 업데이트할 수 있습니다). 이렇게 하면 ProtocolBindAdapterEx 함수가 바인딩 작업을 완료할 수 있습니다.
ProtocolBindAdapterEx 함수가 아직 수행되지 않은 경우 ProtocolOpenAdapterCompleteEx 드라이버가 바인딩에 필요한 리소스를 할당할 수 있습니다.
ProtocolBindAdapterEx NDIS_STATUS_PENDING 반환된 경우 ProtocolOpenAdapterCompleteEx 호출할 수 있습니다. NdisCompleteBindAdapterEx 함수를 사용하여 바인딩 작업을 완료합니다. 이 경우 ProtocolOpenAdapterCompleteEx NDIS가 ProtocolBindAdapterEx전달한 BindContext 핸들을 NdisCompleteBindAdapterEx를 전달합니다. Status 매개 변수가 오류를 나타내는 경우 ProtocolOpenAdapterCompleteExProtocolBindAdapterEx설정된 바인딩 리소스를 해제할 수 있습니다.
NDIS는 IRQL = PASSIVE_LEVEL ProtocolOpenAdapterCompleteEx 호출합니다.
예제
ProtocolOpenAdapterCompleteEx 함수를 정의하려면 먼저 정의하는 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.예를 들어 "MyOpenAdapterCompleteEx"라는 ProtocolOpenAdapterCompleteEx 함수를 정의하려면 이 코드 예제와 같이 PROTOCOL_OPEN_ADAPTER_COMPLETE_EX 형식을 사용합니다.
PROTOCOL_OPEN_ADAPTER_COMPLETE_EX MyOpenAdapterCompleteEx;
그런 다음 다음과 같이 함수를 구현합니다.
_Use_decl_annotations_
VOID
MyOpenAdapterCompleteEx(
NDIS_HANDLE ProtocolBindingContext,
NDIS_STATUS Status
)
{...}
PROTOCOL_OPEN_ADAPTER_COMPLETE_EX 함수 형식은 Ndis.h 헤더 파일에 정의됩니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 PROTOCOL_OPEN_ADAPTER_COMPLETE_EX 함수 형식에 적용되는 주석이 사용되도록 합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버함수 역할 형식을 사용하여 함수 선언을 참조하세요.
Use_decl_annotations대한 자세한 내용은 함수 동작 주석참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.0 이상에서 지원됩니다. |
| 대상 플랫폼 | Windows |
| 헤더 | ndis.h(Ndis.h 포함) |
| IRQL | PASSIVE_LEVEL |