AVC_FUNCTION_GET_UNIQUE_ID

Artigo
06/15/2023

O código da função AVC_FUNCTION_GET_UNIQUE_ID obtém a ID exclusiva da unidade AV/C.

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

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_UNIQUE_ID UniqueID;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Os membros da estrutura AVC_UNIQUE_ID são mostrados abaixo:

typedef struct _AVC_UNIQUE_ID {
    OUT GUID DeviceID;
} AVC_UNIQUE_ID, *PAVC_UNIQUE_ID;

Requisitos

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

Entrada AVC_MULTIFUNC_IRB

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

Uniqueid
Especifica um GUID que representa a unidade como um todo. Todas as subunidades dentro da mesma unidade compartilham o mesmo GUID. Não há duas unidades que compartilhem o mesmo GUID.

Esse código de função não é compatível com instâncias virtuais do avc.sys.

O driver de subunidade usará essa função se precisar relatar o GUID do dispositivo a um aplicativo controlador (um aplicativo que deve saber qual das muitas instâncias do driver de subunidade pertence à mesma unidade) ou se está criando suas próprias estruturas AVCPRECONNECTINFO para plugs externos.

Isso deve ser chamado em IRQL = PASSIVE_LEVEL.