IResourceList 인터페이스(portcls.h)

인터페이스는 IResourceList 플러그 앤 플레이 관리자가 시작 시 디바이스에 할당하는 시스템 하드웨어 리소스 목록인 구성 리소스 목록의 추상화 기능을 제공합니다. 목록의 리소스에는 인터럽트 벡터, DMA 채널, I/O 포트 주소 및 버스 상대 메모리 주소 블록이 포함될 수 있습니다. 자세한 내용은 함수 드라이버에서 디바이스 시작을 참조하세요.

PortCls 시스템 드라이버는 인터페이스를 IResourceList 구현하고 어댑터 드라이버에 노출합니다. PortCls는 어댑터 드라이버의 디바이스 시작 루틴을 호출할 때( 디바이스 시작 참조) 호출 매개 변수 중 하나로 개체를 전달합니다 IResourceList .

헤더 파일 portcls.h는 리소스 목록 개체의 처리를 간소화하기 위해 매크로 집합을 정의합니다. 각 리소스 유형에 대해 다음 4개의 매크로가 정의됩니다.

ULONG
  NumberOfpluralresourcename(
    void
 ); 

PCM_PARTIAL_RESOURCE_DESCRIPTOR
  FindTranslatedsingularresourcename(
    ULONG  Index
    );

PCM_PARTIAL_RESOURCE_DESCRIPTOR
  FindUntranslatedsingularresourcename(
    ULONG  Index
    );

NTSTATUS
  AddsingularresourcenameFromParent(
    PRESOURCELIST  Parent,
    ULONG  Index
    );

다음 표에서는 이러한 매크로가 정의된 리소스 유형을 보여 줍니다.

리소스 유형 이름	단수 양식	복수형
CmResourceTypePort	포트	포트
CmResourceTypeInterrupt	Interrupt	인터럽트
CmResourceTypeMemory	메모리	메모리
CmResourceTypeDma	Dma	Dmas
CmResourceTypeDeviceSpecific	DeviceSpecific	DeviceSpecifics
CmResourceTypeBusNumber	BusNumber	BusNumbers
CmResourceTypePrivate	프라이빗	음부
CmResourceTypeAssignedResource	AssignedResource	AssignedResources
CmResourceTypeSubAllocateFrom	SubAllocateFrom	SubAllocateFroms

 

위의 왼쪽 열에 있는 리소스 종류 이름의 의미는 CM_PARTIAL_RESOURCE_DESCRIPTOR 참조하세요.

다음 표에서는 portcls.h가 9가지 리소스 유형 각각에 대해 정의하는 4개의 매크로를 명시적으로 나열합니다. 각 매크로의 오른쪽에는 메서드에 대한 동일한 호출이 있습니다 IResourceList .

매크로	동등한 IResourceList 호출
NumberOfPorts()	NumberOfEntriesOfType(CmResourceTypePort)
FindTranslatedPort(n)	FindTranslatedEntry(CmResourceTypePort,(n))
FindUntranslatedPort(n)	FindUntranslatedEntry(CmResourceTypePort,(n))
AddPortFromParent(p,n)	AddEntryFromParent((p),CmResourceTypePort,(n))
NumberOfInterrupts()	NumberOfEntriesOfType(CmResourceTypeInterrupt)
FindTranslatedInterrupt(n)	FindTranslatedEntry(CmResourceTypeInterrupt,(n))
FindUntranslatedInterrupt(n)	FindUntranslatedEntry(CmResourceTypeInterrupt,(n))
AddInterruptFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeInterrupt,(n))
NumberOfMemories()	NumberOfEntriesOfType(CmResourceTypeMemory)
FindTranslatedMemory(n)	FindTranslatedEntry(CmResourceTypeMemory,(n))
FindUntranslatedMemory(n)	FindUntranslatedEntry(CmResourceTypeMemory,(n))
AddMemoryFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeMemory,(n))
NumberOfDmas()	NumberOfEntriesOfType(CmResourceTypeDma)
FindTranslatedDma(n)	FindTranslatedEntry(CmResourceTypeDma,(n))
FindUntranslatedDma(n)	FindUntranslatedEntry(CmResourceTypeDma,(n))
AddDmaFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeDma,(n))
NumberOfDeviceSpecifics()	NumberOfEntriesOfType(CmResourceTypeDeviceSpecific)
FindTranslatedDeviceSpecific(n)	FindTranslatedEntry(CmResourceTypeDeviceSpecific,(n))
FindUntranslatedDeviceSpecific(n)	FindUntranslatedEntry(CmResourceTypeDeviceSpecific,(n))
AddDeviceSpecificFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeDeviceSpecific,(n))
NumberOfBusNumbers()	NumberOfEntriesOfType(CmResourceTypeBusNumber)
FindTranslatedBusNumber(n)	FindTranslatedEntry(CmResourceTypeBusNumber,(n))
FindUntranslatedBusNumber(n)	FindUntranslatedEntry(CmResourceTypeBusNumber,(n))
AddBusNumberFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeBusNumber,(n))
NumberOfDevicePrivates()	NumberOfEntriesOfType(CmResourceTypeDevicePrivate)
FindTranslatedDevicePrivate(n)	FindTranslatedEntry(CmResourceTypeDevicePrivate,(n))
FindUntranslatedDevicePrivate(n)	FindUntranslatedEntry(CmResourceTypeDevicePrivate,(n))
AddDevicePrivateFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeDevicePrivate,(n))
NumberOfAssignedResources()	NumberOfEntriesOfType(CmResourceTypeAssignedResource)
FindTranslatedAssignedResource(n)	FindTranslatedEntry(CmResourceTypeAssignedResource,(n))
FindUntranslatedAssignedResource(n)	FindUntranslatedEntry(CmResourceTypeAssignedResource,(n))
AddAssignedResourceFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeAssignedResource,(n))
NumberOfSubAllocateFroms()	NumberOfEntriesOfType(CmResourceTypeSubAllocateFrom)
FindTranslatedSubAllocateFrom(n)	FindTranslatedEntry(CmResourceTypeSubAllocateFrom,(n))
FindUntranslatedSubAllocateFrom(n)	FindUntranslatedEntry(CmResourceTypeSubAllocateFrom,(n))
AddSubAllocateFromFromParent(p,n)	AddEntryFromParent((p),CmResourceTypeSubAllocateFrom,(n))

상속

IResourceList 인터페이스는 IUnknown 인터페이스에서 상속됩니다.

메서드

IResourceList 인터페이스에는 이러한 메서드가 있습니다.

IResourceList::AddEntry AddEntry 메서드는 리소스 목록에 항목을 추가합니다.
IResourceList::AddEntryFromParent AddEntryFromParent 메서드는 리소스 목록의 부모 목록에 있는 항목을 리소스 목록에 추가합니다.
IResourceList::FindTranslatedEntry FindTranslatedEntry 메서드는 지정된 형식의 변환된 항목에 대한 포인터를 반환하고, 이러한 항목이 없으면 NULL을 반환합니다.
IResourceList::FindUntranslatedEntry FindUntranslatedEntry 메서드는 지정된 형식의 변환되지 않은 항목에 대한 포인터를 반환하고, 이러한 포인터가 없으면 NULL을 반환합니다.
IResourceList::NumberOfEntries NumberOfEntries 메서드는 리소스 목록의 리소스 항목 수를 반환합니다.
IResourceList::NumberOfEntriesOfType NumberOfEntriesOfType 메서드는 리소스 목록에서 지정된 형식의 리소스 항목 수를 반환합니다. 각 리소스 종류에 대해 매크로는 앞에서 설명한 대로 이 메서드를 호출하도록 정의됩니다.
IResourceList::TranslatedList TranslatedList 메서드는 번역된 리소스 목록을 반환합니다.
IResourceList::UntranslatedList UntranslatedList 메서드는 변환되지 않은 리소스 목록을 반환합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	portcls.h