AVC_FUNCTION_FIND_PEER_DO

Articolo
06/15/2023

Il codice della funzione AVC_FUNCTION_FIND_PEER_DO individua un'istanza nonvirtualeavc.sys .

Blocco dello stato I/O

Se ha esito positivo, il driver del protocollo AV/C imposta Irp-IoStatus.Status> su STATUS_SUCCESS.

Gli altri valori restituiti possibili includono:

Valore restituito	Descrizione
STATUS_UNSUCCESSFUL	Non è stata trovata un'istanza nonvirtuale di avc.sys
STATUS_INVALID_GENERATION	Si è verificato un ripristino del bus prima che sia stato trovato il riferimento all'oggetto dispositivo. Ottenere un nuovo NodeAddress e riprovare.

Commenti

Questa funzione usa il membro PeerLocator della struttura AVC_MULTIFUNC_IRB, come illustrato di seguito.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PEER_DO_LOCATOR PeerLocator;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Requisiti

Intestazioni: Dichiarato in avc.h. Includere avc.h.

AVC_MULTIFUNC_IRB Input

Common
Il sottomember della funzione di questo membro deve essere impostato su AVC_FUNCTION_FIND_PEER_DO dall'enumerazione AVC_FUNCTION .

PeerLocator
Specifica le istanze nonvirtuali (peer) di avc.sys.

Questa funzione individua un'istanza nonvirtualeavc.sys in base all'indirizzo del nodo del dispositivo rappresentato. Se non viene trovata un'istanza, l'IRP viene completato con uno stato di STATUS_UNSUCCESSFUL. Una volta che si trova un'istanza, il chiamante può inviare eventuali richieste di interfaccia dispositivo GUID_AVC_CLASS tramite l'oggetto . Il chiamante deve rilasciare il riferimento a questo oggetto (tramite ObDereferenceObject) al termine dell'operazione.

Questo codice di funzione può essere chiamato in IRQL <= DISPATCH_LEVEL.