MiniportReset

NDIS_STATUS MiniportReset( OUT PBOOLEAN AddressingReset, IN NDIS_HANDLE MiniportAdapterContext );

MiniportReset함수는 NIC에 대한 하드웨어 리셋을 발생하거나 혹은 드라이버의 소프트웨어 상태를 리셋하는 데 필요한 함수이다.

매개변수

AddressingReset

MiniportReset는 만약 현재 값들에 대한 주소 정보를 회복하기 위해 MiniportSetInformation를 호출해야 한다면은 TRUE로 설정하는 변수를 가리킨다.

MiniportAdapterContext

드라이버가 MiniportInitialize에 의해 설정된 NIC 당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다.

리턴값

MiniportReset은 다음과 같은 값중 하나가 리턴될 수 있다:

NDIS_STATUS_SUCCESS

MiniportReset은 성공적으로 연산 상태에 대한 NIC을 리셋한다.

NDIS_STATUS_PENDING

드라이버는 연산이 행해질 때 NdisMResetComplete을 호출함으로써 비동기적으로 리셋 연산을 완성할 것이다.

NDIS_STATUS_NOT_RESETTABLE

NIC이 소프트웨어 제어아래에서 리셋 능력들을 제공하지 않는다.

NDIS_STATUS_RESET_IN_PROGRESS

MiniportReset은 NIC이 현재 리셋되어진 것을 결정한다. 그래서 이 호출은 superfluous이다.

NDIS_STATUS_SOFT_ERRORS

MiniportReset은 성공적으로 NIC을 리셋하지만은 회복할 수 있는 에러가 연산동안 일어난다. MiniportReset은 에러에 대한 더 많은 정보로 NdisWriteErrorLogEntry을 호출한다.

NDIS_STATUS_HARD_ERRORS

MiniportReset은 NIC을 리셋하기 위해 시도하지만은 회복할 수 없는 에러는 연산하는 동안 발생한다. MiniportReset은 에러에 대한 더 많은 정보로 NdisWriteErrorLogEntry를 호출한다.

주석

MiniportReset은 NIC의 매개변수들을 리셋할 수 있다. 만약 리셋이 NIC의 스테이션 주소내에 변화를 야기한다면은, 미니포트는 자동적으로 리셋에 앞서 스테이션 주소를 앞선 값으로 회복한다. 하드웨어에 의해 리셋되는 어떤 멀티캐스트 혹은 기능적인 주소 마스크들은 이 함수에서 리셋을 할 필요가 없다.

만약 멀티캐스트 혹은 기능적인 주소 정보 혹은 lookahead 크기와 같은 다른 정보는 리셋에 의해 변한다면은, MiniportReset은 제어가 리턴하기 전에 AddressingReset 변수를 TRUE로 설정해야 한다. 이것은 NDIS가 정보를 회복하기 위해 MiniportSetInformation 함수를 호출하는 것을 야기한다.

일반적인 규칙으로, NDIS 인터미디엇 드라이버의 MiniportReset 함수는 항상 AddressingReset을 TRUE로 항상 설정해야 한다. 아랫 NIC 드라이버가 NIC을 리셋할 때까지, 그러한 인터미디엇 드라이버는 그것이 가상 NIC을 위해 주소 정보를 회복해야 하는지를 결정할 수 없다. 인터미디엇 드라이버는 큐에 저장된 보내는 것들 중 NDIS 라이브러리 타이밍을 불가능하게 하고 그 자체에게 NdisMSetAttributesEx에 대한 초기화 시간 호출로 요구하기 때문에, 그러한 드라이버의 MiniportReset 함수는 단지 리셋 요구가 아랫 NIC 드라이버로 지시되어질 때 단지 호출되어진다.

다른 타입들의 장치 드라이버 위에 그들 자신이 놓인 인터미디엇 드라이버들은 또한 MiniportReset 함수를 가져야 한다. 그러한 MiniportReset 함수는 NdisReset에 대한 프로토콜 드라이버의 호출에 의해 초기화된 리셋 요구들을 다뤄야 한다. 만약 인터미디엇 드라이버는 또한 MiniportCheckForHang 함수를 가진다면은, MiniportReset 함수는 MiniportCheckForHang이 TRUE를 호출할 때마다 호출되어질 것이다.

MiniportReset이 NIC을 리셋하기 전에 혹은 NIC의 소프트웨어 상태를 업데이트하기 전에:

• 미니포트는 선택적으로 어떤 지연 OID 요구들을 완성할 것이다. NDIS는 리셋 연산이 마칠 때까지 리셋하는 NIC을 미니포트에 더이상 OID 요구들을 제출하지 않을 것이다. 리셋 후에, NDIS는 지연됐지만은 리셋되기전에 미니포트에 의해 완성하지 못한 어떤 OID 요구들을 미니포트에 다시 제출할 것이다.
• 직렬화된 미니포트는 어떤 지연 보내기 연산들을 완성해야 한다. 만약 미니포트가 리셋을 완성하기 전에, 모든 지연 보내기 연산들이 완성하지 않는다면은, NDIS는 리셋 연산이 마친 후에 실패 상태로 이러한 연산들을 완료할 것이다.
• 비직렬화된 미니포트는 어떤 지연 보내기 연산을 완성해야 한다. NDIS는 NDIS가 그러한 드라이버를 위해 보내기 큐를 유지할 수 없기 때문에 비직렬화된 드라이버를 위해 지연 보내기 패킷들을 다시 큐에 저장하지 않을 것이다.

미니포트는 NDIS가 리셋이 시작되고 끝날 때 바운드된 프로토콜들에게 주지하기 때문에 각 리셋 연산의 시작과 끝을 신호화하기 위해 NdisM(Co)IndicateStatus을 호출할 필요가 없다.

만약 MiniportReset는 리셋 연산동안, NIC에서 상태 변화들을 위하여 기다려야 한다면은, 그것은 NdisStallExecution을 호출할 수 있다. 그러나, MiniportReset 함수는 50마이크로초들보다 더 큰 시간 간격으로 NdisStallExecution을 호출하지 말아야 한다.

모든 NDIS 인터미디엇 드라이버는 MiniportInitialize로부터 NdisMSetAttributesEx를 호출해야 하고 인터미디엇 드라이버에서 요구들과 보내기들을 타임아웃하기 위한 NDIS 시도들을 불가능하게 해야 한다. NDIS는 인터미디어 드라이버의 MiniportCheckForHang 함수를 실행한다,if any, 대략 매 2초마다.

NDIS는 NIC이 리시브들을 멈추는지 결정할 수 없어서, MiniportCheckForHang을 제공하는 것은 드라이버가 이 조건을 위해 NIC을 모니터하고 만약 일어나면은 강제적으로 리셋하는 것을 허락하낟.

디폴트로, MiniportReset은 IRQL DISPATCH_LEVEL을 실행한다.