NdisRequest
VOID
NdisRequest(
OUT PNDIS_STATUS Status,
IN NDIS_HANDLE NdisBindingHandle,
IN PNDIS_REQUEST NdisRequest
);
|
NdisRequest는 NIC의 상태나 능력을 쿼리하거나 NIC의 상태를 설정하기 위해 아래 계층 드라이버에 요구를 포워드한다.
매개변수
- Status
- 이 함수로부터 리턴되는 값을 설정하는 호출자 제공 변수이다. 아래 계층 드라이버는 NDIS_STATUS_XXX로 리턴되어지는 것을 결정한다. 항상 다음과 같은 값들을 가진다.
- NDIS_STATUS_SUCCESS
- 요구된 연산이 성공적으로 마쳤다.
- NDIS_STATUS_INVALID_OID
- NdisRequest에서 NDIS_REQUEST구조의 버퍼의 Oid 멤버내에 지정된 OID_XXX 코드가 유효하지 않거나 아랫계층 드라이버에서 지원하지 않는다.
- NDIS_STATUS_INVALID_LENGTH 혹은 NDIS_STATUS_BUFFER_TOO_SHORT
- NdisRequest에서 NDIS_REQUEST구조의 버퍼의 InformationBufferLength 멤버에서 지정된 주어진 OID_XXX 코드를 위해 필요한 것과 매치되지 않는다. 만약 정보 버퍼가 너무 작으면은, BytesNeeded 멤버는 NdisRequest로부터 리턴된 InformationBufferLength를 위한 올바른 값을 포함한다.
- NDIS_STATUS_INVALID_DATA
- 주어진 NDIS_REQUEST 구조체내에 InformationBuffer에서 제공된 데이터가 주어진 OID_XXX 코드를 위해 유효하지 않다.
- NDIS_STATUS_NOT_SUPPORTED 혹은 NDIS_STATUS_NOT_RECOGNIZED
- 아래 드라이버는 요구된 연산을 지원하지 않는다.
- NDIS_STATUS_RESOURCES
- 요구가 자원부족으로 인해서 만족되지 않을 수 있다. 항상, 이러한 리턴 값은 메모리를 할당하는 시도가 성공적인 못했거나, 같은 요구가, 후에 제출된, 같은 이유로 실패했다는 것을 반드시 지시하지는 않는다.
- NDIS_STATUS_NOT_ACCEPTED
- 아래 계층 드라이버가 항상 NIC에 설정으로 요구된 연산을 시도했지만은 네트워크 카드에 의해 실패한다. 예를 들어 너무 많은 멀티 캐스트 주소들의 설정 시도가 이러한 리턴값을 야기한다.
- NDIS_STATUS_CLOSING 혹은 NDIS_STATUS_CLOSING_INDICATING
- 아래 계층 드라이버가 닫힘이 진행됐기 때문에 요구된 연산을 실패했다.
- NDIS_STATUS_RESET_IN_PROGRESS
- 아래 계층 드라이버가 현재 네트워크 카드를 리셋팅하기 때문에 이 시기에 요구를 만족시킬 수 없다. 호출자의 ProtocolStatus함수는 리셋이 진행중이라고 지시하기 위해 NDIS_STATUS_RESET_START로 호출되어지거나 될 것이다. 이 리턴 값은 같은 요구가, 후에 제출된, 같은 이유로 실패할 것이라고 지시할 필요는 없다.
- NDIS_STATUS_FAILURE
- 이 값은 항상 비특정 디폴트가 아니다. 많은 특정 NDIS_STATUS_XXX의 아무것도 아래 계층 드라이버가 요구를 실패할 것이라고 할 때 리턴되어진다.
- NdisBindingHandle
- 타켓 NIC혹은 호출자와 바운드된 다음 낮은 드라이버의 가상 어댑터를 지정하는 NdisOpenAdapter에 의해 리턴된 핸들을 지정한다.
- NdisRequest
- 쿼리나 셋을 위하여 주어진 OID_XXX 코드로 요구된 연산을 지정하는 버퍼화된 구조체를 가리킨다.
주석
프로토콜 드라이버는 요구될 연산의 OID_XXX와 관련된 정보 버퍼를 충분한 메모리로 할당해야 한다. 드라이버는 또한 NdisRequest를 요출하기 전에 NdisRequest에 버퍼를 할당하고 설정해야 한다. 양쪽 버퍼들은 아래 계층 드라이버가 요구를 처리하는 동안 상승된 IRQL에서 작동하기 때문에 비페이지 풀로부터 할당되어야 한다.
인터미디엇 NDIS 드라이버 위에 층화된 호출자를 위하여, NdisRequest는 요구를 다음 낮은 드라이버로 보낸다. 그것은 호출자의 결정된 방식으로 특정 기능을 다루라고 드라이버에게 지시하거나 자신의 능력에 대한 정보를 리턴한다. 다음 낮은 드라이버가 NDIS 인터미디엇 드라이버이면은, 원래 더 높은 레벨의 프로토콜에 의해 제출된 요구를 완성하기 전에 OID특정 요구를 가진 NdisRequest를 호출할 수 있다.
Status에 리턴된 몇몇 에러들은 회복할 수 있고 다음과 같은 값을 가진다.
NDIS_STATUS_INVALID_OID
NDIS_STATUS_INVALID_LENGTH
NDIS_BUFFER_TOO_SHORT
NDIS_STATUS_INVALID_DATA
NDIS_STATUS_RESOURCES
NDIS_STATUS_RESET_IN_PROGRESS
즉 드라이버는 적당하게 NdisRequest의 패킷을 수정하여 OID_XXX 코드와 InformationBuffer의 버퍼의 내용가 크기를 올바르게 하고 NdisRequest로 요구 패킷을 다시 제출한다. 같은 패킷이 만약 원래 호출이 진행에서 리셋을 가리키거나 일시적으로 리소스 부족이 실행되어지는 요구를 방해한다면은 NdisRequest에 대한 재제출로 만족될 것이다.
NDIS 라이브러리는 아래 미니포트 드라이버를 위하여 바인딩을 유지한다. NDIS는 만약 주어진 OID가 시스템이 필터 라이브러리를 제공하는 것을 위해 시스템 정의 미디엄 타입에 관련되어진다면은 바인딩특정 쿼리를 위한 정보를 리턴할 수 있다.
일반적이고 미디어 특정 OID에 대한 더 많은 정보와 그들의 객관적으로 관련된 정보에 대한 더 많은 정보는 Chapter 5를 보라.
NdisRequest의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행되어질 수 있다.
|