AVC_FUNCTION_FIND_PEER_DO

Artículo
06/15/2023

El código de función AVC_FUNCTION_FIND_PEER_DO busca una instancia de avc.sys no virtual.

Bloque de estado de entrada/salida

Si se ejecuta correctamente, el controlador de protocolo AV/C establece Irp-IoStatus.Status> en STATUS_SUCCESS.

Otros valores devueltos posibles son:

Valor devuelto	Descripción
STATUS_UNSUCCESSFUL	No se encontró una instancia no virtual de avc.sys
STATUS_INVALID_GENERATION	Se produjo un restablecimiento de bus antes de que se encontrara la referencia del objeto de dispositivo. Obtenga un nuevo NodeAddress e inténtelo de nuevo.

Comentarios

Esta función usa el miembro PeerLocator de la estructura AVC_MULTIFUNC_IRB, como se muestra a continuación.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PEER_DO_LOCATOR PeerLocator;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Requisitos

Encabezados: Declarado en avc.h. Incluya avc.h.

entrada de AVC_MULTIFUNC_IRB

Común
El submembrado Function de este miembro debe establecerse en AVC_FUNCTION_FIND_PEER_DO de la enumeración AVC_FUNCTION.

PeerLocator
Especifica las instancias no virtuales (del mismo nivel) de avc.sys.

Esta función busca una instancia de avc.sys no virtual según la dirección del nodo del dispositivo que representa. Si no se encuentra una instancia, el IRP se completa con un estado de STATUS_UNSUCCESSFUL. Una vez que se encuentra una instancia, el autor de la llamada puede enviar cualquier solicitud de interfaz de dispositivo GUID_AVC_CLASS a través del objeto . El autor de la llamada debe liberar la referencia a este objeto (a través de ObDereferenceObject) cuando termine con él.

Se puede llamar a este código de función en IRQL <= DISPATCH_LEVEL.