Compartir a través de

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY función de devolución de llamada (wdfchildlist.h)

  • Artículo

[Solo se aplica a KMDF]

La función de devolución de llamada de eventos EvtChildListIdentificationDescription Copy de un controlador copia una descripción de identificación secundaria de una ubicación especificada a otra.

Sintaxis

EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY EvtWdfChildListIdentificationDescriptionCopy;

void EvtWdfChildListIdentificationDescriptionCopy(
  [in]  WDFCHILDLIST ChildList,
  [in]  PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER SourceIdentificationDescription,
  [out] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER DestinationIdentificationDescription
)
{...}

Parámetros

[in] ChildList

Identificador de un objeto de lista secundaria del marco.

[in] SourceIdentificationDescription

Puntero a una estructura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER que identifica la ubicación de origen de la descripción de identificación secundaria.

[out] DestinationIdentificationDescription

Puntero a una estructura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER que identifica la ubicación de destino de la descripción de identificación secundaria.

Valor devuelto

Ninguno

Observaciones

Si un controlador de bus usa enumeración dinámica, puede registrar un EvtChildListIdentificationDescriptionCopy función de devolución de llamada llamando a WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.

El marco copia información de una descripción de identificación proporcionada por el controlador a otra cuando necesita actualizar una descripción existente con nueva información, o cuando necesita pasar el contenido de una descripción de identificación al controlador.

La función de devolución de llamada EvtChildListIdentificationDescriptionCopy debe copiar el contenido de una descripción de origen en una descripción de destino. Un controlador debe proporcionar esta función de devolución de llamada si el marco no puede llamar a RtlCopyMemory para copiar la descripción de identificación. (El marco no puede llamar a rtlCopyMemory si la descripción contiene punteros a memoria adicional).

Si el controlador no proporciona una función de devolución de llamada EvtChildListIdentificationDescriptionCopy, el marco copia las descripciones de identificación llamando a RtlCopyMemory.

En los pasos siguientes se describe un escenario posible:

  1. El controlador que recorre una lista secundaria llama a WdfChildListRetrieveNextDevice. El controlador proporciona una estructura WDF_CHILD_RETRIEVE_INFO para que pueda recibir la descripción de identificación del dispositivo secundario.
  2. El marco llama a la función de devolución de llamada EvtChildListIdentificationDescriptionCopy (si existe) o rtlCopyMemory para copiar la descripción de identificación del dispositivo. El origen de la operación de copia es la copia interna del marco de la descripción. El destino es la memoria que el controlador asignó e identificó en su estructura WDF_CHILD_RETRIEVE_INFO.
El marco puede usar RtlCopyMemory para copiar una descripción de identificación, si la descripción consta de una sola estructura con un tamaño predeterminado especificado por el IdentificationDescriptionSize miembro de la estructura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER. Sin embargo, a veces la descripción también debe contener información adicional almacenada en memoria asignada dinámicamente. En este caso, normalmente definirá una estructura de descripción para que un miembro apunte a la memoria asignada dinámicamente y el controlador debe proporcionar un EvtChildListIdentificationDescriptionCopy función de devolución de llamada. La función de devolución de llamada debe hacer lo siguiente:
  1. En el sourceIdentificationDescription de la función de devolución de llamada y estructuras destinationIdentificationDescription, busque los punteros a la memoria asignada dinámicamente.
  2. Copie la memoria asignada dinámicamente desde el origen al destino mediante los punteros.
  3. Copie otros miembros de la estructura de la función de devolución de llamada de la estructura SourceIdentificationDescription a la estructura de la función de devolución de llamada DestinationIdentificationDescription.
El único método de objeto framework child-list que la función de devolución de llamada EvtChildListIdentificationDescriptionCopy puede llamar es WdfChildListGetDevice.

El marco adquiere un bloqueo interno de objeto de lista secundaria antes de llamar a la función de devolución de llamada evtChildListIdentificationDescriptionCopy. La función de devolución de llamada solo debe realizar operaciones relacionadas con la operación de copia, como llamar a métodos de objetos de memoria del marco y acceder al espacio de contexto del objeto. No debe llamar a métodos que accedan a otros controladores.

Si el controlador proporciona una función de devolución de llamada EvtChildListIdentificationDescriptionCopy, también podría necesitar EvtChildListIdentificationDescriptionDuplicate, EvtChildListIdentificationDescriptionComparey EvtChildListIdentificationDescriptionCleanup funciones de devolución de llamada.

Para obtener más información sobre la enumeración dinámica, vea Enumerar los dispositivos en un bus.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
versión mínima de KMDF 1.0
encabezado de wdfchildlist.h (incluya Wdf.h)
irQL <= DISPATCH_LEVEL

Consulte también

EvtChildListIdentificationDescriptionCleanup

EvtChildListIdentificationDescriptionCompare

EvtChildListIdentificationDescriptionDuplicate

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfChildListCreate

WdfChildListGetDevice

WdfFdoInitSetDefaultChildListConfig