Método IResourceList::AddEntryFromParent (portcls.h)
El método AddEntryFromParent agrega a una lista de recursos una entrada que se encuentra en la lista primaria de la lista de recursos.
Sintaxis
NTSTATUS AddEntryFromParent(
[in] IResourceList *Parent,
[in] CM_RESOURCE_TYPE Type,
[in] ULONG Index
);
Parámetros
[in] Parent
Puntero al IResourceList objeto desde el que se va a tomar la entrada.
[in] Type
Identifica el tipo de recurso de la entrada que se va a agregar. Para obtener una lista de valores de tipo de recurso válidos, vea la descripción del Tipo miembro de la estructura de CM_PARTIAL_RESOURCE_DESCRIPTOR.
[in] Index
Especifica el índice de la lista primaria de la entrada que se va a agregar. Si el método IResourceList::NumberOfEntriesOfType del elemento primario devuelve un valor n para el número de entradas de tipo Type, los índices válidos van de 0 a n-1. Si index es cero, por ejemplo, el método agrega la primera aparición de una entrada del tipo especificado de la lista primaria.
Valor devuelto
AddEntryFromParent devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado. En la tabla siguiente se muestran algunos de los posibles códigos de estado de retorno.
| Código devuelto | Descripción |
|---|---|
|
Indica que no hay entradas gratuitas en la lista. |
|
Indica que no se encontró la entrada en la lista primaria. |
Observaciones
Para cada tipo de recurso, se define una macro para llamar a este método. Consulte IResourceList .
El parámetro primario de sigue las convenciones de recuento de referencias de para objetos COM.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | portcls.h (incluya Portcls.h) |
| irQL | PASSIVE_LEVEL |