IResourceList インターフェイス (portcls.h)

インターフェイスはIResourceList、構成リソース リストの抽象化を提供します。これは、プラグ アンド プレイ マネージャーが起動時にデバイスに割り当てるシステム ハードウェア リソースの一覧です。 一覧のリソースには、割り込みベクトル、DMA チャネル、I/O ポート アドレス、バス相対メモリ アドレスのブロックを含めることができます。 詳細については、「 Function Driver でのデバイスの起動」を参照してください。

PortCls システム ドライバーは、インターフェイスを IResourceList 実装し、アダプター ドライバーに公開します。 PortCls がアダプター ドライバーのデバイス起動ルーチンを呼び出すとき (デバイス の起動を参照)、呼び出しパラメーターの 1 つとしてオブジェクトを渡 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 ポート Port
CmResourceTypeInterrupt 割り込み 割り込み
CmResourceTypeMemory メモリ 思い出
CmResourceTypeDma Dma Dmas
CmResourceTypeDeviceSpecific Devicespecific DeviceSpecifics
CmResourceTypeBusNumber BusNumber BusNumbers
CmResourceTypePrivate プライベート 陰部
CmResourceTypeAssignedResource AssignedResource AssignedResources
CmResourceTypeSubAllocateFrom SubAllocateFrom SubAllocateFroms
 

上の左側の列のリソースの種類名の意味については、 CM_PARTIAL_RESOURCE_DESCRIPTORを参照してください。

次の表に、9 つのリソースの種類ごとに portcls.h が定義する 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))
AddSubAllocateFromParent(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