PROTOCOL_CM_OPEN_AF 콜백 함수(ndis.h)
ProtocolCmOpenAf 함수가 필요합니다. 이 함수는 호출 관리자가 주소 패밀리를 여는 연결 지향 NDIS 클라이언트와 상호 작용할 수 있도록 열려 있는 리소스당 할당합니다.
구문
PROTOCOL_CM_OPEN_AF ProtocolCmOpenAf;
NDIS_STATUS ProtocolCmOpenAf(
[in] NDIS_HANDLE CallMgrBindingContext,
[in] PCO_ADDRESS_FAMILY AddressFamily,
[in] NDIS_HANDLE NdisAfHandle,
[out] PNDIS_HANDLE CallMgrAfContext
)
{...}
매개 변수
[in] CallMgrBindingContext
통합되지 않은 통화 관리자의 경우 CallMgrBindingContext 는 호출 관리자가 바인딩별 상태 정보를 유지하는 호출 관리자 할당 컨텍스트 영역에 대한 핸들을 지정합니다. 호출 관리자는 NdisOpenAdapterEx를 호출할 때 이 핸들을 제공했습니다.
MCM(통합 통화 관리자)의 경우 CallMgrBindingContext 는 미니포트가 어댑터별 상태 정보를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정합니다. 미니포트는 NdisMSetAttributesEx 호출(5.x 드라이버의 경우) 또는 NdisMSetMiniportAttributes 호출(6.x 드라이버의 경우)에서 이 핸들을 제공했습니다.
[in] AddressFamily
클라이언트가 여는 주소 패밀리를 지정합니다. 호출 관리자가 이 주소 패밀리를 호출했을 때 등록했습니다. NdisCmRegisterAddressFamilyEx.
[in] NdisAfHandle
이 주소 패밀리 instance 고유하게 식별하는 NDIS에서 제공하는 핸들을 지정합니다. 이 핸들은 호출 관리자에 대해 불투명하며 시스템 사용을 위해 예약되어 있습니다.
[out] CallMgrAfContext
호출 관리자가 제공하는 주소 패밀리의 이 열기에 대한 상태를 유지하는 호출 관리자 제공 컨텍스트 영역에 대한 핸들을 지정합니다.
반환 값
ProtocolCmOpenAf는 작업의 상태 다음 중 하나로 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
호출 관리자가 클라이언트에서 이 주소 패밀리로 요청을 수락하는 데 필요한 모든 리소스를 성공적으로 할당하고 초기화했음을 나타냅니다. |
|
요청된 작업이 비동기적으로 처리되고 있음을 나타냅니다. 호출 관리자가 호출해야 합니다. NdisCmOpenAddressFamilyComplete 는 모든 open-AF 작업을 완료하여 작업이 완료되었음을 NDIS(및 클라이언트)에 표시합니다. |
|
호출 관리자가 메모리와 같은 사용 가능한 시스템 리소스가 부족하여 필요한 작업을 완료할 수 없음을 나타냅니다. |
|
호출 관리자가 이 주소 패밀리에서 작동하도록 클라이언트의 요청을 수락할 수 있는 상태로 설정할 수 없음을 나타냅니다. 이는 다른 NDIS 라이브러리 함수에서 전파되는 오류 상태 또는 드라이버 작성기에서 적절하게 결정된 오류 상태 수 있습니다. |
설명
ProtocolCmOpenAf는 호출 관리자 작성기가 이 주소 패밀리의 instance 여는 클라이언트를 대신하여 작업을 수행하는 데 필요하다고 판단되는 동적 리소스 및 구조의 필요한 할당을 수행합니다. 이러한 리소스에는 메모리 버퍼, 데이터 구조, 이벤트 및 기타 유사한 리소스가 포함되지만 이에 국한되지는 않습니다. 또한 호출 관리자는 컨트롤을 NDIS로 반환하기 전에 열려 있는 모든 관련 데이터를 초기화해야 합니다.
호출 관리자가 열려 있는 상태별 영역을 할당한 경우 제어를 NDIS로 반환하기 전에 CallMgrAfContext 핸들에서 상태 영역의 주소를 설정해야 합니다. 이렇게 하려면 CallMgrAfContext 를 역참조하고 데이터 영역에 대한 포인터를 핸들 값으로 저장합니다. 예를 들면 다음과 같습니다.
*CallMgrAfContext = SomeBuffer;
ProtocolCmOpenAf가 이 주소 패밀리를 여는 클라이언트를 대신하여 후속 요청을 수행하는 데 필요한 열린별 리소스를 할당할 수 없는 경우 열린 리소스에 할당된 모든 리소스를 해제하고 NDIS_STATUS_RESOURCES 사용하여 NDIS에 제어를 반환해야 합니다.
ProtocolCmOpenAf가 필요한 작업을 완료하고 CM이 클라이언트의 요청을 수락할 준비가 되면 ProtocolCmOpenAf는 NDIS_STATUS_SUCCESS 상태 가능한 한 빨리 제어를 반환해야 합니다.
예
ProtocolCmOpenAf 함수를 정의하려면 먼저 정의 중인 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버에 대한 코드 분석, SDV( 정적 드라이버 검증 도구 ) 및 기타 확인 도구에서 오류를 찾는 데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.예를 들어 이름이 " MyCmOpenAf"인 ProtocolCmOpenAf 함수를 정의하려면 다음 코드 예제와 같이 PROTOCOL_CM_OPEN_AF 형식을 사용합니다.
PROTOCOL_CM_OPEN_AF MyCmOpenAf;
그런 다음 다음과 같이 함수를 구현합니다.
_Use_decl_annotations_
NDIS_STATUS
MyCmOpenAf(
NDIS_HANDLE CallMgrBindingContext,
PCO_ADDRESS_FAMILY AddressFamily,
NDIS_HANDLE NdisAfHandle,
PNDIS_HANDLE CallMgrAfContext
)
{...}
PROTOCOL_CM_OPEN_AF 함수 형식은 Ndis.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 PROTOCOL_CM_OPEN_AF 함수 형식에 적용되는 주석이 사용되도록 합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요.
Use_decl_annotations 대한 자세한 내용은 함수 동작에 주석을 추가를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(ProtocolCmOpenAf(NDIS 5.1 참조))에 대해 지원됩니다. Windows XP의 NDIS 5.1 드라이버(ProtocolCmOpenAf(NDIS 5.1) 참조)에 대해 지원됩니다. |
| 대상 플랫폼 | Windows |
| 헤더 | ndis.h(Ndis.h 포함) |
| IRQL | <= DISPATCH_LEVEL |
추가 정보
NdisCmOpenAddressFamilyComplete NdisCmRegisterAddressFamilyEx피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기