AVC_FUNCTION_GET_CONNECTINFO
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.