AVC_FUNCTION_SET_CONNECTINFO

Article
06/15/2023

Le code de fonction AVC_FUNCTION_SET_CONNECT_INFO définit la structure AVCCONNECTINFO pour chaque ID de broche (décalage de zéro).

Bloc d’état E/S

En cas de réussite, le pilote de protocole AV/C définit Irp-IoStatus.Status> sur STATUS_SUCCESS.

Les autres valeurs de retour possibles sont les suivantes :

Valeur retournée	Description
STATUS_TIMEOUT	La demande a été effectuée, mais aucune réponse n’a été reçue avant l’expiration du délai d’attente et le traitement des nouvelles tentatives.
STATUS_REQUEST_ABORTED	Abandonner immédiatement lorsque le status d’achèvement IRP est STATUS_REQUEST_ABORTED. Cela indique que l’appareil a été supprimé ou n’est plus disponible sur le bus 1394.
STATUT_*	Tout autre code de retour indique qu’une erreur ou un avertissement s’est produit au-delà de la portée du protocole AV/C.

Commentaires

Cette fonction utilise le membre SetConnectInfo de la structure AVC_MULTIFUNC_IRB comme indiqué ci-dessous.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_SETCONNECT_INFO SetConnectInfo;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Spécifications

En-têtes: Déclaré dans avc.h (Inclure avc.h)

entrée AVC_MULTIFUNC_IRB

Commun
Le sous-membre Function de ce membre doit être défini sur AVC_FUNCTION_SET_CONNECTINFO à partir de l’énumération AVC_FUNCTION.

SetConnectInfo
Spécifie les informations de connexion pour l’appareil AV/C.

Ce code de fonction n’est pas pris en charge par les instances virtuelles de avc.sys.

Un pilote de sous-unité doit utiliser cette fonction s’il fournit un gestionnaire d’intersection. La structure AVCCONNECTINFO (contenue dans la structure AVC_SET_CONNECTINFO) est dérivée des structures AVCPRECONNECTINFO qui sont ajoutées aux plages de données passées au gestionnaire d’intersection.

Après avoir déterminé que les plages de données sont compatibles, le gestionnaire d’intersection génère une structure AVCCONNECTINFO. Cette structure est ajoutée au format de données résultant et également envoyée à avc.sys. Peu importe si le format de données proposé est transmis ultérieurement à un format de données supérieur, car avc.sys met en cache une seule structure AVCCONNECTINFO.

Cela doit être appelé à l’adresse IRQL = PASSIVE_LEVEL.