AVC_FUNCTION_GET_UNIQUE_ID

Artikel
06/15/2023

Der AVC_FUNCTION_GET_UNIQUE_ID Funktionscode ruft die eindeutige ID der AV/C-Einheit 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 UniqueID-Member der AVC_MULTIFUNC_IRB-Struktur, wie unten gezeigt.

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_UNIQUE_ID UniqueID;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Die Member der AVC_UNIQUE_ID-Struktur sind unten dargestellt:

typedef struct _AVC_UNIQUE_ID {
    OUT GUID DeviceID;
} AVC_UNIQUE_ID, *PAVC_UNIQUE_ID;

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_GET_UNIQUE_ID aus der AVC_FUNCTION-Enumeration festgelegt werden.

Uniqueid
Gibt eine GUID an, die die Einheit als Ganzes darstellt. Alle Untereinheiten innerhalb derselben Einheit verwenden dieselbe GUID. Keine zwei Einheiten verwenden dieselbe GUID.

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

Der Untereinheitstreiber verwendet diese Funktion, wenn er die Geräte-GUID an eine steuernde Anwendung melden muss (eine Anwendung, die wissen muss, welche der vielen Untereinheitstreiberinstanzen in dieselbe Einheit gehört) oder wenn sie eigene AVCPRECONNECTINFO-Strukturen für externe Plugs erstellt.

Dies muss unter IRQL = PASSIVE_LEVEL aufgerufen werden.