AVC_FUNCTION_GET_CONNECTINFO

Artículo
06/15/2023

El código de función AVC_FUNCTION_GET_CONNECT_INFO obtiene la estructura AVCPRECONNECTINFO para cada identificador de patilla (desplazamiento de cero).

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_TIMEOUT	La solicitud se realizó, pero no se recibió ninguna respuesta antes de que se completara todo el tiempo de espera y se completó el procesamiento de reintento.
STATUS_REQUEST_ABORTED	Anule inmediatamente cuando se STATUS_REQUEST_ABORTED el estado de finalización de IRP. Esto indica que el dispositivo se ha quitado o ya no está disponible en el bus 1394.
ESTADO_*	Cualquier otro código de retorno indica que se produjo un error o una advertencia que estaba fuera del ámbito del protocolo AV/C.

Comentarios

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

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PRECONNECT_INFO PreConnectInfo;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

A continuación se muestran los miembros de la estructura de AVC_PRECONNECT_INFO:

typedef struct _AVC_PRECONNECT_INFO {
    IN ULONG PinId
    OUT AVCPRECONNECTINFO ConnectInfo;
} AVC_PRECONNECT_INFO, *PAVC_PRECONNECT_INFO;

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_GET_CONNECTINFO de la enumeración AVC_FUNCTION.

ConnectInfo
Especifica la información de conexión del dispositivo AV/C.

Las instancias virtuales de avc.sysno admiten este código de función.

Un controlador de subunidad debe usar esta función si es responsable de crear los intervalos de datos incluidos en la estructura KSPIN_DESCRIPTOR. La estructura AVCPRECONNECTINFO se anexa al miembro DataRanges para las conexiones externas al equipo.

Se debe llamar a en IRQL = PASSIVE_LEVEL.