NdisMGetDeviceProperty

VOID NdisMGetDeviceProperty( IN NDIS_HANDLE MiniportAdapterHandle, IN OUT PDEVICE_OBJECT *PhysicalDeviceObject OPTIONAL, IN OUT PDEVICE_OBJECT *FunctionalDeviceObject OPTIONAL, IN OUT PDEVICE_OBJECT *NextDeviceObject OPTIONAL, IN OUT PCM_RESOURCE_LIST *AllocatedResources OPTIONAL, IN OUT PCM_RESOURCE_LIST *AllocatedResourcesTranslated OPTIONAL );

NdisMGetDeviceProperty 함수는 버스 드라이버를 통해 미니포트와 통신을 설정하는데 필요한 디바이스 객체들을 검색한다.

매개변수

MiniportAdapterHandle

미니포트의 NIC을 지정하는 NDIS 핸들을 지정한다. 이 핸들은 원래 MiniportInitialize에 전달되어진다.

PhysicalDeviceObject

호출자 할당 버퍼의 포인터. 버퍼는 미니포트를 위해서 실제 장치를 표시하는 DEVICE_OBJECT 구조체의 포인터를 수신한다. 이 포인터는 선택적이다. 이 구조체에 대한 자세한 것은 Kernel-Mode Driver Reference을 봐라.

FunctionalDeviceObject

호출자 할당 버퍼의 포이터이다. 버퍼는 DEVICE_OBJECT 구조체에 대한 포인터를 수신한다. DEVICE_OBJECT는 NDIS가 실제 장치를 위해 만든 기능적인 객체를 나타낸다. 이 포인터는 선택적이다.

NextDeviceObject

호출자 할당 버퍼의 포인터를 나타낸다. 버퍼는 다음 장치 객체를 표시하는 DEVICE_OBJECT 구조체에 대한 포인터를 수신한다. 이 다음 디바이스 객체는 미니포트에 속한 기능적인 장치 객체에 의해 체인내에서 선행되어진다. NDIS는 실제 장치를 위한 이러한 기능적인 장치 객체를 만든다. 예를 들어, 다음 장치 객체는 버스 드라이버 혹은 HAL과 관련된 객체가 될 수 있다. 이 포인터는 선택적이다.

AllocatedResources

CM_RESOURCE_LIST 구조체에 대한 포인터를 수신하는 호출자 할당 버퍼에 대한 포인터. CM_RESOURCE_LIST는 PnP 관리자가 실제 장체에 할당한 하드웨어 자원들의 리스트을 설명한다. 이 리스트는 즉 HAL에 의해 번역이 안된 그 상태 그대로의 자원들을 포함한다. 이 포인터는 선택적이다. 이 구조체에 대한 더 자세한 내용은 Kernel-Mode Driver Reference를 봐라.

AllocatedResourcesTranslated

CM_RESOURCE_LIST 구조체에 대한 포인터를 수신하는 호출자 할당 버퍼에 대한 포인터. M_RESOURCE_LIST는 PnP 관리자가 실제 장체에 할당한 하드웨어 자원들의 리스트을 설명한다. 이 장치는 HAL에 의해 번역된 번역된 형태로 자원들을 포함한다. 이 포인터는 선택적이다.

주석

미니포트 드라이버들은 그들의 통신들을 설정하기 위한 특정 정보를 설정해야 한다. 버스 드라이버들을 통해 통신하는 미니포트 인스턴스들을 위한 미니포트 드라이버들은 이러한 정보를 얻기 위해 NdisMGetDeviceProperty를 사용한다. 예를 들어, USB 혹은 IEEE 1394에 연결된 미니포트 인스턴스들은 윗쪽 계층에 표준 NDIS 미니포트 인터페이스를 노출하고 아랫 계층에 특정 버스를 위한 클래스 인터페이스를 사용하는 미니포트 드라이버들을 요구한다. USB나 혹은 1394 클래스 인터페이스 사용을 위해, 미니포트 드라이버는 I/O 요구 패킷들(IRP)을 만들고 제출한다. 미니포트 드라이버는 NdisMGetDeviceProperty가 특정 버스를 위해 클래스 인터페이스에 IRP들을 제출하기 위해 검색한 실제 그리고 다음 디바이스 객체들을 사용한다. 버스 드라이버들을 위해 IRP들을 만들고 제출하는 것에 대한 더 자세한 정보가 위치한 곳은 Kernel-Mode 드라이버 디자인 가이드를 봐라.

NdisMGetDeviceProperty로 검색한 실제, 기능, 다음 장치 객체들을 위해 DEVICE_OBJECT에 대한 포인터들은 미니포트 드라이버에게 선명하지 않은 단순한 핸들들이다.

전형적으로, 미니포트 드라이버들은 NdisMQueryAdapterResources 함수을 호출해서 그들의 NIC들을 위해 하드웨어 자원 리스트를 얻기 위해 NDIS_RESOURCE_LIST 구조체에 대한 포인터를 전달한다. NDIS_RESOURCE_LIST 구조체는 Windows 2000 플랫폼에서 CM_PARTIAL_RESOURCE_LIST 구조체와 동등하다. 이 구조체에 대한 자세한 정보는 Kernel-Mode Driver Reference를 봐라. 대체적으로 미니포트 드라이버들은 "raw" 혹은 "translated" 자원들에 대한 포인터들을 검색하기 위해 NdisMGetDeviceProperty를 호출할 수 있다. Raw 자원들은 HAL에 의해 번역이 안되었다. Translated 자원들은 HAL에 의해 번역되었다. raw와 translated 자원들의 대한 더 자세한 정보는 Plug and Play를 봐라.

만약 Windows 95/98 미니포트 드라이버는 raw 혹은 translated 자원들에 대한 포인터를 요구한다면은 NDIS는 AllocatedResources 와 AllocatedResourcesTranslated 매개변수에 NULL로 설정하는 것을 주목하라.

NdisMGetDeviceProperty의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.