Compartilhar via


AVC_FUNCTION_PEER_DO_LIST

O código da função AVC_FUNCTION_PEER_DO_LIST localiza todas as instâncias deavc.sysnão virtuais.

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_INSUFFICIENT_RESOURCES Não foi possível obter espaço para a lista de referências de objeto do dispositivo.

Comentários

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

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PEER_DO_LIST PeerList;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

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

PeerList
Especifica uma lista de todas as instâncias não virtuais (par) de avc.sys.

O chamador pode enviar GUID_AVC_CLASS solicitações da Interface do Dispositivo por meio de qualquer um dos objetos retornados na lista de objetos. O chamador deve liberar as referências a esses objetos (por meio de ObDereferenceObject) e liberar a memória que contém a lista (por meio de ExFreePool) quando terminar.

Esse código de função pode ser chamado em IRQL >= DISPATCH_LEVEL.

Confira também

AVC_MULTIFUNC_IRB

AVC_PEER_DO_LIST

AVC_FUNCTION

DEVICE_OBJECT

ObDereferenceObject

ExFreePool