NDIS_REQUEST
typedef struct _NDIS_REQUEST {
UCHAR MacReserved[16];
NDIS_REQUEST_TYPE RequestType;
union _DATA {
struct QUERY_INFORMATION {
NDIS_OID Oid;
PVOID InformationBuffer;
UINT InformationBufferLength;
UINT BytesWritten;
UINT BytesNeeded;
} QUERY_INFORMATION;
struct SET_INFORMATION {
NDIS_OID Oid;
PVOID InformationBuffer;
UINT InformationBufferLength;
UINT BytesRead;
UINT BytesNeeded;
} SET_INFORMATION;
} DATA;
} NDIS_REQUEST, *PNDIS_REQUEST;
|
NDIS_REQUEST는 NdisRequest 함수에 대한 호출을 위해 프로토콜 혹은 NDIS에 의해 설정된 패킷을 지정한다. NDIS는 아래 드라이버의 MiniportQueryInformation 혹은 MiniportSetInformation 함수들에 이러한 요구들을 제출한다.
멤버
- MacReserved[16]
- 아래 드라이버에 의해 사용이 예약된 16바이트 영역을 지정한다.
- RequestType
- 다음과 같은 하나로 요구 타입을 지정한다:
- NdisRequestQueryInformation
- 쿼리 정보 요구를 지정한다. NDIS는 그러한 요구를 아래 드라이버의 MiniportQueryInformation 함수에 포워드한다.
- NdisRequestSetInformation
- 설정 정보 요구를 지정한다. NDIS는 아래 드라이버의 MiniportSetInformation 함수에 대한 요구를 포워드한다.
- NdisRequestQueryStatistics
- 쿼리 통계 요구를 지정한다. 대부분의 통계 쿼리에서, NDIS는 그 자체로 요구를 만족한다. 그렇지 않으면, NDIS는 그러한 요구를 아래 드라이버의 MiniportQueryInformation 함수로 포워드한다. 이러한타입의 요구는 프로토콜 드라이버가 결코 아닌 사용자 모드 어플리케이션에서 왔다.
선행값들의 어떤 값을 위해, Oid 멤버내에 지정된 OID_XXX는 요구된 연산의 타입으로 호환될 것이다.
- NdisRequestOpen
- 이러한 타입은 폐기되었다. 프로토콜 드라이버는 그 대신에 NdisOpenAdapter 함수를 호출한다.
- NdisRequestClose
- 이 타입은 폐기되었다. 프로토콜 드라이버는 그 대신에 NdisCloseAdapter 함수를 호출한다.
- NdisRequestSend
- 이 타입은 폐기되었다. 프로토콜 드라이버는 NdisSend 혹은 NdisSendPackets 함수를 호출한다.
- NdisRequestTransferData
- 이 타입은 폐기되었다. 프로토콜 드라이버는 NdisTransferData 함수를 호출한다.
- NdisRequestReset
- 이 타입은 폐기되었다. 프로토콜 드라이버는 NdisReset 함수를 호출한다.
- NdisRequestGeneric1
- NIC 드라이버 특정 요구를 지정한다.
- NdisRequestGeneric2
- NIC 드라이버 특정 요구를 지정한다.
- NdisRequestGeneric3
- NIC 드라이버 특정 요구를 지정한다.
- NidsRequestGeneric4
- NIC 드라이버 특정 요구를 지정한다.
- Oid
- 요구된 연산의 객체 지시자를 지정한다.
이 값은 OID_XXX 코드이다.
- InformationBuffer
- 아래 드라이버 혹은 NDIS는 아래 드라이버가 설정들을 위한 호출자 제공 정보를 읽어오는 것으로부터 혹은 쿼리를 위한 요구된 정보를 리턴하는 버퍼를 가리킨다.
- InformationBufferLength
- InformationBuffer인 버퍼의 바이트 크기를 지정한다. Oid 값은 이 멤버에 적당한 값을 결정한다.
- BytesWritten
- 아래 드라이버 혹은 NDIS가 쿼리 정보 요구들을 위한 InfomationBuffer인 버퍼로 전송하는 바이트 수를 지정한다. 만약 NdisRequest 함수가 NDIS_STATUS_INVALID_LENGTH를 리턴하면, 이 멤버의 값은 의미가 없다.
- BytesNeeded
- 쿼리 정보를 리턴하거나 혹은 주어진 OID_XXX 코드에 의해 요구된 설정 연산을 실행하기 위해 필요한 바이트 수를 지정한다.
만약 NdisRequest 함수가 NDIS_STATUS_SUCCESS를 리턴하면, 이 멤버의 값은 의미가 없다. 만약 InformationBufferLength는 쿼리에서 주어진 OID_XXX 값이 너무 값다면, 이 멤버는 얼마나 큰 버퍼가 이 요구를 만족하는 데 필요한지를 가리킨다. 만약 InformationBuffer인 버퍼가 설정에서 주어진 OID_XXX 를 위해 충분한 데이터를 포함하지 않는다면, 이 멤버는 얼마나 많은 데이터가 요구되는지를 가리킨다.
주석
프로토콜은 InformationBuffer인 버퍼를 위한 그리고 NDIS_REQUEST 패킷 그 자체를 위해 비페이지화된 메모리를 할당해야 한다.
페이지화된 메모리로부터 할당된 패킷 혹은 버퍼를 전달하는 것은 아래 드라이버가 요구된 연산을 실행하기 위해 IRQL DISPATCH_LEVEL에서 실행하기 때문에 치명적인 페이지 폴트들을 야기할 수 있다.
NDIS_REQUEST 구조체는 프로토콜 드라이버가 아래 드라이버에 요구할 수 있는 각 타입의 연산을 위한 DATA 구조체를 포함한다. NdisRequest 함수를 호출하기 전에, 프로토콜은 Oid 멤버를 지정하는 쿼리 혹은 설정 연산을 나타내는 서브구조체의 관계된 멤버들을 채운다. NDIS 혹은 아래 드라이버버는 호출자에게 제어를 리턴하기 전에 남아있는 멤버들을 채운다. OID_XXX 코드들에 대한 더 많은 정보와 어느 시스템 정의 OID들이 쿼리, 통계 쿼리들 혹은 설정 쿼리들을 허용하는 가에 대한 더 자세한 정보는 Part 2를 봐라.
NdisRequestGenerics 타입들은 그들 자신의 내부 요구들을 만드는 NIC 드라이버들을 위해 이용할수 있다. 요구된 연산을 인디케이트하기 위해, NIC 드라이버는 내부 변수를 이러한 타입들의 하나로 설정한다.
|