Freigeben über


AVC_FUNCTION_PEER_DO_LIST

Der AVC_FUNCTION_PEER_DO_LIST Funktionscode sucht alle nichtvirtuellen avc.sys-Instanzen .

E/A-Statusblock

Bei erfolgreicher Ausführung legt der AV/C-Protokolltreiber Irp-IoStatus.Status> auf STATUS_SUCCESS fest.

Mögliche andere Rückgabewerte sind:

Rückgabewert BESCHREIBUNG
STATUS_INSUFFICIENT_RESOURCES Es konnte kein Speicherplatz für die Liste der Geräteobjektverweise abgerufen werden.

Kommentare

Diese Funktion verwendet das PeerList-Element der AVC_MULTIFUNC_IRB-Struktur, wie unten gezeigt.

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

Anforderungen

Header: Deklariert in avc.h. Schließen Sie avc.h ein.

AVC_MULTIFUNC_IRB-Eingabe

Common
Der Unterteil Function dieses Members muss auf AVC_FUNCTION_PEER_DO_LIST aus der AVC_FUNCTION-Enumeration festgelegt werden.

PeerList
Gibt eine Liste aller nichtvirtuellen Instanzen (Peerinstanzen) von avc.sysan.

Der Aufrufer kann GUID_AVC_CLASS Geräteschnittstellenanforderungen über jedes der in der Objektliste zurückgegebenen Objekte übermitteln. Der Aufrufer muss die Verweise auf diese Objekte (über ObDereferenceObject) freigeben und den Speicher mit der Liste (über ExFreePool) freigeben, wenn er fertig ist.

Dieser Funktionscode kann unter IRQL >= DISPATCH_LEVEL aufgerufen werden.

Weitere Informationen

AVC_MULTIFUNC_IRB

AVC_PEER_DO_LIST

AVC_FUNCTION

DEVICE_OBJECT

ObDereferenceObject

ExFreePool