AVC_FUNCTION_ACQUIRE

  • Artigo

O código da função AVC_FUNCTION_ACQUIRE faz com queavc.sys estabeleça todas as conexões sugeridas por valores AVCCONNECTINFO armazenados em cache.

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 PinId da estrutura AVC_MULTIFUNC_IRB, conforme mostrado abaixo.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PIN_ID PinId;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

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_ACQUIRE da enumeração AVC_FUNCTION.

PinId
Especifica o deslocamento (ou ID) do pino para o qual uma conexão deve ser adquirida.

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

Um driver de subunidade deve usar essa função quando o pino ficar ativo.

Isso deve ser chamado em IRQL = PASSIVE_LEVEL.

Confira também

AVC_MULTIFUNC_IRB

AVC_PIN_ID

AVC_FUNCTION