NdisMGetDeviceProperty 함수(ndis.h)

  • 아티클

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

구문

void NdisMGetDeviceProperty(
  [in]            NDIS_HANDLE       MiniportAdapterHandle,
  [out, optional] PDEVICE_OBJECT    *PhysicalDeviceObject,
  [out, optional] PDEVICE_OBJECT    *FunctionalDeviceObject,
  [out, optional] PDEVICE_OBJECT    *NextDeviceObject,
  [out, optional] PCM_RESOURCE_LIST *AllocatedResources,
  [out, optional] PCM_RESOURCE_LIST *AllocatedResourcesTranslated
);

매개 변수

[in] MiniportAdapterHandle

미니포트 어댑터를 식별하는 NDIS 핸들입니다. 이 핸들은 원래 에 전달되었습니다. MiniportInitializeEx 함수입니다.

[out, optional] PhysicalDeviceObject

호출자가 할당한 버퍼에 대한 포인터입니다. 버퍼는 미니포트 어댑터의 물리적 디바이스를 나타내는 DEVICE_OBJECT 구조체에 대한 포인터를 받습니다. 이 포인터는 선택 사항입니다.

[out, optional] FunctionalDeviceObject

호출자가 할당한 버퍼에 대한 포인터입니다. 버퍼는 DEVICE_OBJECT 구조체에 대한 포인터를 받습니다. DEVICE_OBJECT NDIS가 물리적 디바이스에 대해 만드는 기능 디바이스 개체를 나타냅니다. 이 포인터는 선택 사항입니다.

[out, optional] NextDeviceObject

호출자가 할당한 버퍼에 대한 포인터입니다. 버퍼는 다음 디바이스 개체를 나타내는 DEVICE_OBJECT 구조체에 대한 포인터를 받습니다. 이 다음 디바이스 개체는 미니포트 드라이버에 속하는 기능적 디바이스 개체가 체인 앞에 섰습니다. NDIS는 물리적 디바이스에 대해 이 기능적 디바이스 개체를 만듭니다. 예를 들어 다음 디바이스 개체는 버스 드라이버와 연결된 개체이거나 HAL 이 포인터는 선택 사항입니다.

[out, optional] AllocatedResources

CM_RESOURCE_LIST 구조체에 대한 포인터를 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다. CM_RESOURCE_LIST PnP 관리자가 물리적 디바이스에 할당하는 하드웨어 리소스 목록을 설명합니다. 이 목록에는 HAL에서 번역하지 않는 원시 형식의 리소스가 포함되어 있습니다. 이 포인터는 선택 사항입니다.

[out, optional] AllocatedResourcesTranslated

CM_RESOURCE_LIST 구조체에 대한 포인터를 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다. CM_RESOURCE_LIST PnP 관리자가 물리적 디바이스에 할당하는 하드웨어 리소스 목록을 설명합니다. 이 목록에는 번역된 형식의 리소스, 즉 HAL에서 번역한 리소스가 포함되어 있습니다. 이 포인터는 선택 사항입니다.

반환 값

없음

설명

미니포트 드라이버는 통신을 설정하기 위해 특정 정보를 검색해야 합니다. 버스 드라이버를 통해 통신하는 미니포트 인스턴스용 미니포트 드라이버는 NdisMGetDeviceProperty 를 사용하여 이 정보를 검색합니다. 예를 들어 USB(유니버설 직렬 버스) 또는 IEEE 1394 버스에 연결되는 미니포트 드라이버 인스턴스에는 위쪽 가장자리에 표준 NDIS 미니포트 드라이버 인터페이스를 노출하고 아래쪽 가장자리의 특정 버스에 클래스 인터페이스를 사용하는 미니포트 드라이버가 필요합니다. USB 또는 1394 클래스 인터페이스를 사용하기 위해 미니포트 드라이버는 I/O IRP(요청 패킷)를 만들고 제출합니다. 미니포트 드라이버는 NdisMGetDeviceProperty 가 검색하는 물리적 및 다음 디바이스 개체를 사용하여 특정 버스의 클래스 인터페이스에 IRP를 제출합니다. 버스 드라이버에 IRP를 만들고 제출하는 방법에 대한 자세한 내용은 IRP 처리를 참조하세요.

NdisMGetDeviceProperty가 검색하는 물리적, 기능적 및 다음 디바이스 개체에 대한 DEVICE_OBJECT 대한 포인터는 미니포트 드라이버에 불투명한 핸들일 뿐입니다.

미니포트 드라이버는 NdisMGetDeviceProperty 를 호출하여 "원시" 또는 "번역된" 리소스에 대한 포인터를 검색할 수 있습니다. HAL에서 원시 리소스를 변환하지 않았습니다. 번역된 리소스가 있습니다. 원시 및 번역된 리소스에 대한 자세한 내용은 플러그 앤 플레이 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 5.1 및 NDIS 6.0 이상에서 지원됩니다. NDIS 5.1 드라이버는 NdisMGetDeviceProperty(NDIS 5.1)를 참조하세요.
대상 플랫폼 유니버설
헤더 ndis.h(Ndis.h 포함)
라이브러리 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 Irql_Miniport_Driver_Function(ndis)

추가 정보

DEVICE_OBJECT

MiniportInitializeEx