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.