AVC_FUNCTION_GET_PIN_DESCRIPTOR

Artikel
06/15/2023

Der AVC_FUNCTION_GET_PIN_DESCRIPTOR Funktionscode ruft den Pindeskriptor 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 PinDescriptor-Member der AVC_MULTIFUNC_IRB-Struktur, wie unten gezeigt.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PIN_DESCRIPTOR PinDescriptor;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Anforderungen

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

AVC_MULTIFUNC_IRB-Eingabe

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

PinDescriptor
Gibt die Beschreibung eines Pins auf einem AV/C-Untereinheitsgerät an.

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

Zusätzlich zum Stiftdeskriptor gibt diese Funktion möglicherweise auch die Adresse eines Überschneidenshandlers und einen undurchsichtigen Kontextwert zurück, der dem Überschneiden-Handler zugeordnet ist. Wenn der Intersect-Handlermember NULL ist, muss der Untereinheitstreiber einen Überschneidenden Handler bereitstellen.If the intersect handler is NULL, the subunit driver must provide an intersect handler. Wenn der Intersect-Handlerm nicht NULL ist, wird ein Überschneidenden Handler bereitgestellt, und der Treiber kann ihn verwenden.

Avc.sys stellt nie eine Daten schnittmenge bereit, aber ein Filtertreiber (z. B. avcstrm.sys) füllt sie aus, wenn die Anforderung wieder über den Stapel abgeschlossen wird.

Dies muss unter IRQL = PASSIVE_LEVEL aufgerufen werden.