AVC_FUNCTION_SET_CONNECTINFO
Der AVC_FUNCTION_SET_CONNECT_INFO-Funktionscode legt die AVCCONNECTINFO-Struktur für jede Pin-ID (Offset von 0) fest.
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 vor dem Timeout und dem Abschluss der Wiederholungsverarbeitung wurde keine Antwort empfangen. |
| STATUS_REQUEST_ABORTED | Sofortiger Abbruch, wenn die status der IRP-Vervollständigung STATUS_REQUEST_ABORTED wird. Dies bedeutet, dass das Gerät entfernt wurde oder nicht mehr auf dem Bus 1394 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 das SetConnectInfo-Element der AVC_MULTIFUNC_IRB-Struktur , wie unten gezeigt.
typedef struct _AVC_MULTIFUNC_IRB {
AVC_IRB Common;
union {
.
.
.
AVC_SETCONNECT_INFO SetConnectInfo;
.
.
.
};
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;
Anforderungen
Header: Deklariert in avc.h (Include avc.h)
AVC_MULTIFUNC_IRB Eingabe
Common
Der Unterstamm dieses Elements muss auf AVC_FUNCTION_SET_CONNECTINFO aus der AVC_FUNCTION-Enumeration festgelegt werden.
SetConnectInfo
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 einen Überschneidenshandler bereitstellt. Die AVCCONNECTINFO-Struktur (in der AVC_SET_CONNECTINFO-Struktur enthalten) wird von den AVCPRECONNECTINFO-Strukturen abgeleitet, die an die Datenbereiche angefügt werden, die an den Intersect-Handler übergeben werden.
Nachdem festgestellt wurde, dass die Datenbereiche kompatibel sind, generiert der Intersect-Handler eine AVCCONNECTINFO-Struktur. Diese Struktur wird an das resultierende Datenformat angefügt und auch an avc.sysgesendet. Es spielt keine Rolle, ob das vorgeschlagene Datenformat später für ein besseres übergeben wird, da avc.sys nur eine AVCCONNECTINFO-Struktur zwischenspeichert.
Dies muss unter IRQL = PASSIVE_LEVEL aufgerufen werden.