NdisReadEisaSlotInformation

VOID NdisReadEisaSlotInformation( OUT PNDIS_STATUS Status, IN NDIS_HANDLE WrapperConfigurationContext, OUT PUINT SlotNumber, OUT PNDIS_EISA_FUNCTION_INFORMATION EisaData );

NdisReadEisaSlotInformation 함수는 EISA 버스에 있는 NIC을 위해서 EISA 구성 정보를 리턴한다.

매개변수

Status

다음중 하나로 호출상태를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다:

NDIS_STATUS_SUCCESS

NIC 드라이버는 그것을 지원하는 NIC이 발견됐는지를 결정하기 위해서 버퍼화된 구성 데이타를 검사할 수 있다. 만약 그렇다면 어떤 NdisXxx 초기화 함수의 매개변수로써 버스관련 구성 값을 사용할 수 있다.

NDIS_STATUS_RESOURCES

NDIS는 EISA 구성 정보를 수집하기 위해서 필요한 자원을 할당하지 않았다.

NDIS_STATUS_FAILURE

이것은 NIC이 EISA 버스에서 발견되지 않거나 호출자가 유효하지 않은 매개변수를 제공했다면 리턴되는 기본적인 상태이다. 예를들어 NdisMSetAttributes(Ex) 함수가 호출됐을 때 호출자가 AdapterType을 NdisInterfaceEisa가 아닌 다른 것으로 설정했다면 NdisReadEisaSlotInformation 함수는 이 상태를 리턴한다.

WrapperConfigurationContext

MiniportInitialize로 입력되는 핸들을 서술한다.

SlotNumber

이 호출이 성공적이라면 EISA 버스에서 발견된 NIC의 슬롯넘버를 리턴하는 이 함수의 변수를 가리킨다.

EisaData

적어도 sizeof(NDIS_EISA_FUNCTION_INFORMATION) 이어야하는 호출자 할당 버퍼를 가리킨다.

주석

NdisReadEisaSlotInformation 함수는 EISA I/O 버스에서 발견된 NIC에 대해서 표준 EISA 버스 구성정보를 읽는다. 그리고 버스관련 구성정보를 버퍼 안으로 복사한다.

NdisReadEisaSlotInformation 함수 호출이 성공한다면 이 함수는 NDIS_EISA_FUNCTION_INFORMATION 구조체로 포맷된 EisaData에 호출자 제공 버퍼로 정보를 리턴한다.

NDIS_EISA_FUNCTION_INFORMATION 구조체는 다음과 같이 정의한다:

typedef struct _NDIS_EISA_FUNCTION_INFORMATION {

    ULONG CompressedId;

    UCHAR IdSlotFlags1;

    UCHAR IdSlotFlags2;

    UCHAR MinorRevision;

    UCHAR MajorRevision;

    UCHAR Selections[26];

    UCHAR FunctionFlags;

    UCHAR TypeString[80];

    EISA_MEMORY_CONFIGURATION EisaMemory[9];

    EISA_IRQ_CONFIGURATION EisaIrq[7];

    EISA_DMA_CONFIGURATION EisaDma[4];

    EISA_PORT_CONFIGURATION EisaPort[60];

    UCHAR InitializationData[60];

} NDIS_EISA_FUNCTION_INFORMATION, *PNDIS_EISA_FUNCTION_INFORMATION;

멤버	의미
CompressedId	장치를 위해서 EISA의 간결한 ID를 서술한다.
IdSlotFlags1	바이트 0 식별자와 슬롯 정보를 서술한다.
IdSlotFlags2	바이트 1 식별자와 슬롯 정보를 서술한다.
MinorRevision	.cfg 화일의 마이너 수정 레벨을 서술한다.
MajorRevision	.cfg 화일의 메이저 수정 레벨을 서술한다.
Selections[26]	26 selection을 위한 배열을 서술한다.
FunctionFlags	함수 플래그를 서술한다.
TypeString[80]	타입과 서브타입 아스키 문자열을 위한 배열을 서술한다.
EisaMemory[9]	각각의 요소가 버스관련 장치의 메모리 범위를 정의하는 EISA_MEMORY_CONFIGURATION 구조체인 배열을 서술한다.
EisaIrq[7]	각각의 요소가 버스관련 장치 인터럽트를 정의하는 EISA_IRQ_CONFIGURATION 구조체인 배열을 서술한다.
EisaDma[4]	각각의 요소가 버스관련 DMA 능력, 타이밍, 채널 넘버를 정의하는 EISA_DMA_CONFIGURATION 구조체의 배열을 서술한다.
EisaPort[60]	각각의 요소가 버스관련 장치의 I/O 포트 범위를 정의하는 EISA_PORT_CONFIGURATION 구조체의 배열을 서술한다.
InitializationData[60]	EISA 초기화 데이타의 배열을 서술한다.

NIC 드라이버는 현재 플랫폼에서 그들 각각의 어댑터를 확인하기 위해서 NdisReadEisaSlotInformation 함수를 호출한다. 특정 드라이버의 NIC이 발견됐을 때 EisaData레 리턴된 버스관련 구성 매개변수는 NdisMRegisterInterrupt (EisaIrq), NdisMMapIoSpace (EisaMemory), 그리고 NdisMRegisterIoPortRange (EisaPort)와 같이 함수로의 순차적인 호출에서 전달된다.

리턴된 정보를 소비한 후에 NdisReadEisaSlotInformation 함수의 호출자는 EisaData에 할당한 메모리를 해제할 책임이 있다.

NdisReadEisaSlotInformation 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.