AVC_FUNCTION_GET_CONNECTINFO

Artigo
06/15/2023

O código da função AVC_FUNCTION_GET_CONNECT_INFO obtém a estrutura AVCPRECONNECTINFO para cada ID de pino (deslocamento de zero).

Bloco de Status de E/S

Se tiver êxito, o driver de protocolo AV/C definirá Irp-IoStatus.Status> como STATUS_SUCCESS.

Outros valores retornados possíveis incluem:

Valor retornado	Descrição
STATUS_TIMEOUT	A solicitação foi feita, mas nenhuma resposta foi recebida antes de todo o tempo limite e o processamento de repetição foi concluído.
STATUS_REQUEST_ABORTED	Anula imediatamente quando o status de conclusão do IRP é STATUS_REQUEST_ABORTED. Isso indica que o dispositivo foi removido ou não está mais disponível no barramento 1394.
STATUS_*	Qualquer outro código de retorno indica que ocorreu um erro ou aviso que estava além do escopo do protocolo AV/C.

Comentários

Essa função usa o membro PreConnectInfo da estrutura AVC_MULTIFUNC_IRB, conforme mostrado abaixo.

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

Os membros da estrutura AVC_PRECONNECT_INFO são mostrados abaixo:

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

Requisitos

Cabeçalhos: Declarado em avc.h. Inclua avc.h.

Entrada AVC_MULTIFUNC_IRB

Comum
O submembro Function desse membro deve ser definido como AVC_FUNCTION_GET_CONNECTINFO da enumeração AVC_FUNCTION.

ConnectInfo
Especifica as informações de conexão para o dispositivo AV/C.

Não há suporte para esse código de função em instâncias virtuais do avc.sys.

Um driver de subunidade deverá usar essa função se for responsável por criar os intervalos de dados incluídos na estrutura KSPIN_DESCRIPTOR. A estrutura AVCPRECONNECTINFO é acrescentada ao membro DataRanges para conexões externas ao computador.

Isso deve ser chamado em IRQL = PASSIVE_LEVEL.