AVC_FUNCTION_GET_PIN_DESCRIPTOR

Artículo
06/15/2023

El código de función AVC_FUNCTION_GET_PIN_DESCRIPTOR obtiene el descriptor de anclaje 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 PinDescriptor de la estructura AVC_MULTIFUNC_IRB, como se muestra a continuación.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PIN_DESCRIPTOR PinDescriptor;
 .
    .
    .
  };
} 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_GET_PIN_DESCRIPTOR de la enumeración AVC_FUNCTION.

PinDescriptor
Especifica la descripción de un pin en un dispositivo de subunidad AV/C.

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

Además del descriptor de anclaje, esta función también puede devolver la dirección de un controlador de intersección y un valor de contexto opaco asociado al controlador intersect. Si el miembro del controlador intersect es NULL, el controlador de subunidad debe proporcionar un controlador intersect. Si el miembro del controlador intersect no es NULL, se proporciona un controlador intersect y el controlador puede usarlo.

Avc.sys nunca proporciona una intersección de datos, pero un controlador de filtro (por ejemplo, avcstrm.sys) lo rellena a medida que se completa la solicitud de copia de seguridad a través de la pila.

Se debe llamar a en IRQL = PASSIVE_LEVEL.