ProtocolClRegisterSapComplete
VOID
ProtocolClRegisterSapComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE ProtocolSapContext,
IN PCO_SAP Sap,
IN NDIS_HANDLE NdisSapHandle
);
|
들어오는 호출들을 수락하는 연결 지향 NDIS 클라이언트들은 그들이 NdisClRegisterSap 함수로 초기화한 비동기 연산들을 완성하기 위해 ProtocolClRegisterSapComplete 함수들을 가져야 한다. 그렇지 않으면, 그러한 프로토콜 드라이버의 등록된 ProtocolClRegisterSapComplete 함수는 간단히 제어를 리턴한다.
매개변수
- Status
- 다음과 같은 하나의 값이 될 수 있는 NdisClRegisterSap에 대한 클라이언트의 호출의 마지막 상태를 지정한다.
- NDIS_STATUS_SUCCESS
- SAP는 NDIS에게 클라이언트의 ProtocolClIncomingCall 함수를 호출하도록 하는 주어진 SAP에 전해지는 들어오는 호출 제의를 수신할 때마다 NdisCmDispatchIncomingCall 함수를 계속해서 호출할 콜 매니저와 NDIS에게 등록된다.
- NDIS_STATUS_RESOURCES
- NDIS 혹은 콜 매니저는 SAP를 등록하고 유지하기 위한 필요한 자원들을 할당할 수 없거나 초기화할 수 없다.
- NDIS_STATUS_INVALID_DATA
- 클라이언트는 유효한지 검사하기 위해 콜 매니저의 ProtocolCmRegisterSap 함수로 포워드한 NDIS에게 Sap 유효하지 않은 사양을 제공한다. (애매)
- NDIS_STATUS_XXX
- 콜 매니저는 주어진 SAP를 등록하기 위해 시도하는 에러를 접하고 NDIS는 이러한 CM 결정 실패 상태를 클라이언트에게 전달한다.
- ProtocolSapContext
- 클라이언트는 원래 NdisClRegisterSap 함수를 호출할 때 NDIS에게 제공한 클라이언트의 SAP당 컨텍스트 영역에 대한 핸들을 지정한다. 만약 등록이 성공적이라면, NDIS는 이러한 컨텍스트 핸들을 유지하고 이러한 SAP에 속한 클라이언트의 ProtocolClIncomingComingCall 함수에 대한 계속적이 호출에서 사용한다.
- Sap
- SAP가 연 사양을 포함하는 클라이언트 할당 버퍼를 가리킨다. 클라이언트는 원래 이러한 포인터를 NdisClRegisterSap 함수에 전달한다.
- NdisSapHandle
- 만약 Status는 NDIS_STATUS_SUCCESS 이면, 클라이언트 지정 SAP를 위한 클라이언트와 특정 콜 매니저 사이에 NDIS와 설립된 관계인 이러한 등록된 SAP에 대한 NDIS 제공 유효한 핸들을 지정한다. 그렇지 않으면, 이러한 매개변수는 NULL이다. 클라이언트는 NdisClDeregisterSap함수에 대한 궁극적인 호출을 위해 ProtocolSapContext 영역네애 유효한 핸들을 저장해야 한다.
주석
NDIS는 NdisClRegisterSap에 대한 클라이언트의 전 호출이 NDIS에 의해 그리고 만약 NDIS가 그러한 호출이 실패한다면 클라이언트가 NdisClRegisterSap 함수에 전달한 NdisAfHandle을 공유한 콜 매니저에 의해 처리되는 것을 가리키기 위해 ProtocolClRegisterSapComplete 함수를 호출한다.
연결 지향 NIC을 통해 들어오는 호출들을 수신하기 위해, 클라이언트의 ProtocolCoAfRegisterNotify 함수 혹은 ProtocolClOpenAfComplete 함수에 항상 하나나 그 이상의 SAP들을 콜 매니저에게 등록한다.
각 SAP를 등록하기 위해, 클라이언트는 클라이언트가 들어오는 호출들의 주지들을 수신하기를 원하는 콜 매니저를 지정하는 NdisAfHandle을 전달하면서 NdisClRegisterSap 함수를 호출하고 NDIS는 만약 NdisClRegisterSap 함수에 대한 클라이언트의 호출이 성공적이라면 등록된 SAP에 대한 NdisSapHandle를 클라이언트에게 리턴한다. ProtocolClRegisterSapComplete 함수는 나중에 NdisClDeregisterSap 함수로 SAP를 해제할 수 있게 하기 위해 클라이언트의 SAP 당 ProtocolSapContext 영역내에 각 유효한 NdisSapHandle를 저장해야 한다.
SAP의 포맷은 콜 매니저의 특정이다. 만약 콜 매니저가 클라이언트가 등록을 시도하는 것이 SAP를 인식하지 않는다면 혹은 만약 특정 SAP가 이미 사용중이라면, 콜 매니저는 SAP 등록을 실패할 수 있다. ProtocolClRegisterSapComplete 함수는 더 처리하기 전에 NDIS_STATUS_SUCCESS를 위해 입력 Status를 체크해야 한다. 만약 SAP를 등록하는 시도가 실패한다면, ProtocolClRegisterSapComplete 함수는 SAP당 컨텍스트 영역과 클라이언트가 할당하거나 NdisClRegisterSap에 대한 또 한번의 호출로 재사용을 위해 그들을 준비하는 Sap 버퍼를 해제할 수 있다.
클라이언트는 SAP 등록이 아직 지연도안, 즉, ProtocolClRegisterSapComplete 함수가 호출되기 전에 SAP에 들어오는 호출을 수신할 수 있다.
ProtocolClRegisterSapComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.
|