Interfaz IResourceList (portcls.h)

La IResourceList interfaz proporciona una abstracción de una lista de recursos de configuración, que es una lista de los recursos de hardware del sistema que el administrador de Plug and Play asigna a un dispositivo en tiempo de inicio. Los recursos de la lista pueden incluir vectores de interrupción, canales DMA, direcciones de puerto de E/S y bloques de direcciones de memoria relativas al bus. Para obtener más información, vea Iniciar un dispositivo en un controlador de funciones.

El controlador del sistema PortCls implementa la IResourceList interfaz y la expone a los controladores del adaptador. Cuando PortCls llama a la rutina de inicio del dispositivo del controlador del adaptador (vea Iniciar un dispositivo), pasa un IResourceList objeto como uno de los parámetros de llamada.

El archivo de encabezado portcls.h define el conjunto de macros para simplificar el control de objetos de lista de recursos. Para cada tipo de recurso, se definen las cuatro macros siguientes:

ULONG
  NumberOfpluralresourcename(
    void
 ); 

PCM_PARTIAL_RESOURCE_DESCRIPTOR
  FindTranslatedsingularresourcename(
    ULONG  Index
    );

PCM_PARTIAL_RESOURCE_DESCRIPTOR
  FindUntranslatedsingularresourcename(
    ULONG  Index
    );

NTSTATUS
  AddsingularresourcenameFromParent(
    PRESOURCELIST  Parent,
    ULONG  Index
    );

En la tabla siguiente se muestran los tipos de recursos para los que se definen estas macros.

Nombre del tipo de recurso Formulario singular Formulario plural
CmResourceTypePort Port Puertos
CmResourceTypeInterrupt Interrupción Interrupciones
CmResourceTypeMemory Memoria Memorias
CmResourceTypeDma Dma Dmas
CmResourceTypeDeviceSpecific Devicespecific DeviceSpecifics
CmResourceTypeBusNumber BusNumber BusNumbers
CmResourceTypePrivate Privada Privadas
CmResourceTypeAssignedResource AssignedResource AssignedResources
CmResourceTypeSubAllocateFrom SubAllocateFrom SubAllocateFroms
 

Para conocer los significados de los nombres de tipo de recurso en la columna izquierda anterior, consulte CM_PARTIAL_RESOURCE_DESCRIPTOR.

En la tabla siguiente se enumeran explícitamente las cuatro macros que portcls.h define para cada uno de los nueve tipos de recursos. A la derecha de cada macro es la llamada equivalente a un IResourceList método .

Macro Llamada A IResourceList equivalente
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))

Herencia

La interfaz IResourceList hereda de la interfaz IUnknown.

Métodos

La interfaz IResourceList tiene estos métodos.

 
IResourceList::AddEntry

El método AddEntry agrega una entrada a una lista de recursos.
IResourceList::AddEntryFromParent

El método AddEntryFromParent agrega a una lista de recursos una entrada que se encuentra en la lista primaria de la lista de recursos.
IResourceList::FindTranslatedEntry

El método FindTranslatedEntry devuelve un puntero a una entrada traducida del tipo especificado o NULL si no se encuentra dicha entrada.
IResourceList::FindUntranslatedEntry

El método FindUntranslatedEntry devuelve un puntero a una entrada sin traducir del tipo especificado, o NULL si no se encuentra dicho puntero.
IResourceList::NumberOfEntries

El método NumberOfEntries devuelve el número de elementos de recursos de la lista de recursos.
IResourceList::NumberOfEntriesOfType

El método NumberOfEntriesOfType devuelve el número de elementos de recursos de un tipo determinado en la lista de recursos. Para cada tipo de recurso, se define una macro para llamar a este método como se ha descrito anteriormente.
IResourceList::TranslatedList

El método TranslatedList devuelve la lista de recursos traducidos.
IResourceList::UntranslatedList

El método UntranslatedList devuelve la lista de recursos sin traducir.

Requisitos

   
Plataforma de destino Windows
Encabezado portcls.h