AVC_FUNCTION_SET_CONNECTINFO

Artículo
06/15/2023

El código de función AVC_FUNCTION_SET_CONNECT_INFO establece la estructura AVCCONNECTINFO para cada identificador de patilla (desplazamiento desde cero).

Bloque de estado de entrada/salida

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

Entre los posibles otros valores devueltos se incluyen:

Valor devuelto	Descripción
STATUS_TIMEOUT	Se realizó la solicitud, pero no se recibió ninguna respuesta antes de que se completara todo el tiempo de espera y se completara 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 advertencia que estaba fuera del ámbito del protocolo AV/C.

Comentarios

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

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

Requisitos

Encabezados: Declarado en avc.h (incluir avc.h)

entrada de AVC_MULTIFUNC_IRB

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

SetConnectInfo
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 subbúnit debe usar esta función si proporciona un controlador intersect. La estructura AVCCONNECTINFO (incluida dentro de la estructura AVC_SET_CONNECTINFO) se deriva de las estructuras AVCPRECONNECTINFO que se anexan a los intervalos de datos pasados al controlador intersect.

Después de determinar que los intervalos de datos son compatibles, el controlador de intersección genera una estructura AVCCONNECTINFO. Esta estructura se anexa al formato de datos resultante y también se envía a avc.sys. No importa si el formato de datos propuesto se pasa para un mejor, ya que avc.sys solo almacena en caché una estructura AVCCONNECTINFO.

Se debe llamar a en IRQL = PASSIVE_LEVEL.