NdisReset
VOID
NdisReset(
OUT PNDIS_STATUS Status,
IN NDIS_HANDLE NdisBindingHandle
);
|
NdisReset 함수는 하부의 드라이버로 리셋 리퀘스트를 전달한다.
매개변수
- Status
- 이 함수의 리턴에서 설정된 호출자 제공 변수를 가리킨다. 하부의 드라이버는 NDIS_STATUS_XXX가 리턴되는지를 결정하지만 대부분 다음중 하나의 값이다:
- NDIS_STATUS_SUCCESS
- 하부의 드라이버는 NIC 혹은 가상 NIC을 처음 상태로 리셋한다.
- NDIS_STATUS_PENDING
- 리퀘스트는 비동기적으로 처리되고 있고 호출자의 ProtocolResetComplete 함수는 리퀘스트가 완료될 때 호출된다.
- NDIS_STATUS_RESET_IN_PROGRESS
- 하부의 드라이버가 현재 NIC을 리셋중이기 때문에 이 리퀘스트는 부적절하다. 게다가 호출자의 ProtocolStatus 함수는 리셋이 진행중임을 알리기 위해서 NDIS_STATUS_RESET_START를 가지고 호출될 것이다.
- NDIS_STATUS_NOT_RESETTABLE
- 하부의 NIC은 소프트웨어 명령에 의해서는 리셋될 수 없다.
- NDIS_STATUS_ADAPTER_REMOVED 혹은 NDIS_STATUS_FAILURE
- 호출자의 바인딩이 이미 닫혔고 리셋은 이 호출자를 위해서 시도되지 않을 것이다.
- NDIS_STATUS_CLOSING
- 호출자의 바인딩이 현재 닫히고 있고 리셋은 이 호출자를 위해서 시도되지 않을 것이다.
- NDIS_STATUS_SOFT_ERRORS
- 하부의 NIC 드라이버는 넷카드를 리셋하지만 이 연산동안에 회복이 가능한 하나이상의 하드웨어 에러가 발생한다. NIC 드라이버는 에러를 저장했다.
- NDIS_STATUS_HARD_ERRORS
- 하부의 NIC 드라이버가 넷카드 리셋을 시도했지만 이 연산동안에 회복이 가능한 하드웨어 에러가 발생한다. NIC 드라이버는 에러를 저장했다.
- NDIS_STATUS_NOT_ACCEPTED
- 이 값은 보통 NDIS 혹은 하부의 NIC 드라이버로 하여금 리퀘스트를 실패하도록하는 특정 NDIS_STATUS_XXX가 없을 때 리턴되는 비특정 디폴트이다.
- NdisBindingHandle
- 호출자가 바인딩하는 다음 하위 드라이버의 가상 어댑터 혹은 타겟 NIC을 확인시키는 NdisOpenAdapter 함수에 의해서 리턴된 핸들을 서술한다.
주석
프로토콜이 NdisReset 함수를 호출했을 때 NDIS가 내부적으로 큐에 저장된 시작하는 프로토콜로의 보내기 리퀘스트를 완료할 때까지 NDIS 라이브러리는 하부 NIC 드라이버의 MiniportReset 함수를 호출하지 않는다. NDIS가 하부의 NIC 드라이버를 위해서 보내기 큐를 클리어한 후에만 NDIS는 드라이버의 MiniportReset 함수를 호출한다.
하부의 드라이버가 내부적으로 보내기 패킷을 큐에 저장한다면 하부의 드라이버는 NIC의 리셋시도 전에 현재 큐에 저장하는 보내기 패킷을 완료한다.
결국 같은 NIC에 바인딩된 모든 프로토콜 드라이버는 리셋연산동안에 특정 보내기 패킷을 유지해야한다. 리셋의 시작점에서 NDIS는 NDIS_STATUS_RESET_START를 가지고 각각의 바인딩된 프로토콜의 ProtocolStatus 함수를 호출하고 그리고나서는 대응하는 ProtocolStatusComplete 함수를 호출한다. 리셋연산에 행해졌을 때 NDIS는 NDIS_STATUS_RESET_END를 가지고 다시 각각의 바인딩된 프로토콜의 ProtocolStatus 함수를 호출한다. 그리고나서 대응하는 ProtocolStatusComplete 함수를 호출한다.
같은 NIC에 바인딩된 다른 드라이버처럼 NdisReset 함수를 호출하는 드라이버의 ProtocolStatus와 ProtocolStatusComplete 함수는 이 통보를 받는다. 그러나 NdisReset 함수가 STATUS_PENDING을 리턴한다면 리셋연산이 행해졌을 때 원래 호출자의 ProtocolResetComplete 함수만이 인식된다.
NDISWAN과 바인딩된 프로토콜은 결코 NdisReset 함수를 호출하지 않는다.
NdisReset 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.
|