AVC_FUNCTION_GET_CONNECTINFO

2023-06-15

Der AVC_FUNCTION_GET_CONNECT_INFO Funktionscode ruft die AVCPRECONNECTINFO-Struktur für jede Pin-ID (Offset von 0) ab.

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_TIMEOUT	Die Anforderung wurde gestellt, aber es wurde keine Antwort empfangen, bevor alle Timeout- und Wiederholungsverarbeitungen abgeschlossen waren.
STATUS_REQUEST_ABORTED	Sofortiger Abbruch, wenn die status STATUS_REQUEST_ABORTED. Dies gibt an, dass das Gerät entfernt wurde oder im Bus 1394 nicht mehr verfügbar ist.
STATUS_*	Jeder andere Rückgabecode gibt an, dass ein Fehler oder eine Warnung aufgetreten ist, die außerhalb des Geltungsbereichs des AV/C-Protokolls lag.

Kommentare

Diese Funktion verwendet den PreConnectInfo-Member der AVC_MULTIFUNC_IRB-Struktur, wie unten gezeigt.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PRECONNECT_INFO PreConnectInfo;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Die Member der AVC_PRECONNECT_INFO-Struktur sind unten dargestellt:

typedef struct _AVC_PRECONNECT_INFO {
    IN ULONG PinId
    OUT AVCPRECONNECTINFO ConnectInfo;
} AVC_PRECONNECT_INFO, *PAVC_PRECONNECT_INFO;

Anforderungen

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

AVC_MULTIFUNC_IRB-Eingabe

Common
Der Function-Unterteil dieses Elements muss auf AVC_FUNCTION_GET_CONNECTINFO aus der AVC_FUNCTION-Enumeration festgelegt werden.

ConnectInfo
Gibt die Verbindungsinformationen für das AV/C-Gerät an.

Dieser Funktionscode wird von virtuellen Instanzen von avc.sysnicht unterstützt.

Ein Untereinheitstreiber muss diese Funktion verwenden, wenn er für die Erstellung der Datenbereiche verantwortlich ist, die in der KSPIN_DESCRIPTOR-Struktur enthalten sind. Die AVCPRECONNECTINFO-Struktur wird für Verbindungen außerhalb des PCs an den DataRanges-Member angefügt.

Dies muss unter IRQL = PASSIVE_LEVEL aufgerufen werden.