MiniportSetInformation
NDIS_STATUS
MiniportSetInformation(
IN NDIS_HANDLE MiniportAdapterContext,
IN NDIS_OID Oid,
IN PVOID InformationBuffer,
IN ULONG InformationBufferLength,
OUT PULONG BytesRead,
OUT PULONG BytesNeeded
);
|
MiniportSetInformation은 멀티캐스트 주소들의 변화와 같은, 미니포트가 특정 OID들을 위해
유지하는 상태 정보의 변화를 요구하게 바운드된 프로토콜 드라이버들을 (혹은 NDIS) 허락하는
필요한 함수이다.
매개변수
- MiniportAdapterContext
- 드라이버가 MiniportInitialize에 의해 설정된 NIC 당 상태를 유지하는 미니포트 할당 컨텍스트
영역에 대한 핸들을 지정한다.
- Oid
- 드라이버가 실행해야 하는 설정 연산을 지정하는 시스템 정의 OID_XXX 코드를 지정한다.
- InformationBuffer
- 설정을 위해 MiniportSetInformation에 의해 사용돈 OID 특정 데이터를 포함하는 버퍼를 가리킨다.
- InformationBufferLength
- InformationBuffer의 바이트 수를 지정한다.
- BytesRead
- MiniportSetInformation가 InformationBuffer에서 버퍼로부터 읽는 바이트 수를 설정하는 변수를 가리킨다.
- BytesNeeded
- MiniportSetInformation가 만약 InformationBufferLength가 Oid 요구들보타 작다면 요구를 만족시키기 위해
필요한 추가적인 바이트 수를 설정하는 변수를 가리킨다.
리턴값
MiniportSetInformation는 다음 값 중 하나를 리턴할 수 있다:
- NDIS_STATUS_SUCCESS
- MiniportSetInformation은 주어진 Oid에 의해 요구된 상태에 대한 NIC 혹은 그 자체로 설정하기 위해
InformationBuffer에서 데이터를 사용하고 그것이 사용된 데이터에 제공된 양을 BytesRead에
변수를 설정한다.
- NDIS_STATUS_PENDING
- 드라이버는 비동기적으로 그 자체 혹은 NIC이 요구된 상태를 설정할 때 NdisMSetInformationComplete에
대한 호출로 요구를 완성할 것이다.
- NDIS_STATUS_INVALID_OID
- MiniportSetInformation은 Oid를 인식하지 않는다.
- NDIS_STATUS_INVLAID_LENGTH
- InformationBufferLength는 주어진 Oid에 의해 필요한 길이와 매치하지 않는다.
MiniportSetInformation은 버퍼가 BytesNeeded에서 얼마나 많은 바이트 수가 되는지를 리턴한다.
- NDIS_STATUS_INVALID_DATA
- InformationBuffer에 제공된 데이터는 주어진 Oid를 위하여 유효하지 않다.
- NDIS_STATUS_NOT_ACCEPTED
- MiniportSetInformation은 NIC으로부터 요구된 정보를 모으려고 했지만은 성공하지 못했다.
- NDIS_STATUS_NOT_SUPPORTED
- MiniportSetInformation은 Oid를 지원하지 않는다. 선택적이다.
- NDIS_STATUS_RESOURCES
- MiniportSetInformation은 자원 제한 때문에 요구된 연산을 실행할 수 없다. 이 리턴 값은
반드시 나중에 제출된 같은 요구가 같은 이유로 실패한다고는 의미하지 않는다.
주석
NDIS는 미니포트에 대한 바인딩을 관리하는 것과 같은 자기 자신을 위해서 혹은 바운된 프로토콜
드라이버가 NdisRequest를 호출할 때 MiniportSetInformation을 호출한다.
만약 MiniportSetInformation은 NDIS_STATUS_PENDING을 리턴한다면은, 드라이버는 NdisMSetInformationComplete
을 호출함으로써 나중에 요구를 완성해야 한다. 어떤 요구가 완성될 때까지 미니포트는 안전하게
InformationBuffer, BytesRead, BytesNeeded로 메모리를 접근할 수 있다.
미니포트가 어떤 설정 요구를 완성한 후, 이러한 변수들과 버퍼의 소유가 NDIS에게 바뀌고 혹은
NdisRequest의 호출자로 바뀐다. 메모리가 할당된 것이 무엇인든지.
MiniportSetInformation에 대한 호출 후에, NDIS는 그것이 연산을 완성할 때까지 동기든 비동기든간에,
드라이버에 대하느 요구들을 제출하지 않는다.
그대신에 NDIS는 현재 설정 연산이 완성될 때까지 큐에 저장된 요구들을 유지한다.
시스템 정의 OID들에 대하여 더 많은 정보를 위하여 Part 2를 봐라.
MiniportSetInformation은 인터럽트에 의해 선점당할 수 있다.
디폴트로 MiniportSetInformation은 IRQL DISPATCH_LEVEL에서 실행한다.
|