NdisReadEisaSlotInformationEx

VOID NdisReadEisaSlotInformationEx( OUT PNDIS_STATUS Status, IN NDIS_HANDLE WrapperConfigurationContext, OUT PUINT SlotNumber, OUT PNDIS_EISA_FUNCTION_INFORMATION *EisaData, OUT PUINT NumberOfFunctions );

NdisReadEisaSlotInformationEx 함수는 EISA 버스에 있는 NIC에 대한 EISA 구성 정보를 리턴한다.

매개변수

Status

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

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_RESOURCES

NDIS는 리퀘스트된 EISA 구성정보를 포함하는 버퍼를 할당하지 않았거나 구성정보를 수집하기 위해서 필요한 자원을 할당하지 않았다.

NDIS_STATUS_FAILURE

이것은 호출자가 유효하지 않은 매개변수를 제공했을 때 리턴되는 기본 상태이다. 예를들어 미니포트가 NdisMSetAttributes(Ex) 함수를 호출했을 때 호출자가 AdapterType에 NdisInterfaceEisa가 아닌 다른 것을 설정했다면 NdisReadEisaSlotInformationEx 함수는 이 상태를 리턴한다.

WrapperConfigurationContext

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

SlotNumber

EISA 버스에 있는 NIC에 대한 슬롯넘버를 리턴하는 이 함수의 변수를 가리킨다.

EisaData

수집되는 정보의 포인터를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다. 미니포트는 NdisReadEisaSlotInformationEx 함수를 호출하기 전에 EisaData에 변수를 NULL로 설정해야한다.

NumberOfFunctions

구성 정보로 모아진 EISA 기능의 수를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다.

주석

NdisReadEisaSlotInformationEx 함수는 추가된 구성 데이타가 사용될 수 있다면 NdisReadEisaSlotInformation 함수보다 EISA 버스에 있는 NIC에 대해서 더 많은 구성정보를 수집한다.

NdisReadEisaSlotInformationEx 함수의 호출이 성공한다면 이 함수는 추가적으로 사용가능한 NDIS_EISA_FUNCTION_INFORMATION 구조화된 데이타에 의해서 뒤따르는 NdisReadEisaSlotInformation로써 같은 EISA 구성정보를 리턴한다. NDIS_EISA_FUNCTION_INFORMATION 구조체에 대한 더 많은 정보는 NdisReadEisaSlotInformation을 봐라. NdisReadEisaSlotInformationEx 함수는 사용가능한 구성 데이타를 포한하기 위해서 충분히 큰 버퍼를 할당하고 EisaData에 변수를 이 버퍼의 주소로 리셋한다.

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