AVC_FUNCTION_GET_UNIQUE_ID

Articolo
06/15/2023

Il codice della funzione AVC_FUNCTION_GET_UNIQUE_ID ottiene l'ID univoco dell'unità AV/C.

Blocco dello stato I/O

In caso di esito positivo, il driver del protocollo AV/C imposta Irp-IoStatus.Status> su STATUS_SUCCESS.

Gli altri valori restituiti possibili includono:

Valore restituito	Descrizione
STATUS_TIMEOUT	La richiesta è stata effettuata, ma non è stata ricevuta alcuna risposta prima di tutto il timeout e l'elaborazione dei nuovi tentativi è stata completata.
STATUS_REQUEST_ABORTED	Interrompere immediatamente quando lo stato di completamento di IRP è STATUS_REQUEST_ABORTED. Ciò indica che il dispositivo è stato rimosso o non è più disponibile nel bus 1394.
STATO_*	Qualsiasi altro codice restituito indica che si è verificato un errore o un avviso che non rientra nell'ambito del protocollo AV/C.

Commenti

Questa funzione usa il membro UniqueID della struttura AVC_MULTIFUNC_IRB, come illustrato di seguito.

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

Di seguito sono riportati i membri della struttura AVC_UNIQUE_ID:

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

Requisiti

Intestazioni: Dichiarato in avc.h. Includere avc.h.

AVC_MULTIFUNC_IRB Input

Common
Il sottomemo Function di questo membro deve essere impostato su AVC_FUNCTION_GET_UNIQUE_ID dall'enumerazione AVC_FUNCTION.

Uniqueid
Specifica un GUID che rappresenta l'unità nel suo complesso. Tutte le sottounità all'interno della stessa unità condividono lo stesso GUID. Nessuna unità condivide lo stesso GUID.

Questo codice di funzione non è supportato dalle istanze virtuali di avc.sys.

Il driver subunit usa questa funzione se deve segnalare il GUID del dispositivo a un'applicazione di controllo (un'applicazione che deve conoscere quali delle numerose istanze del driver subunit appartengono nella stessa unità) o se sta creando le proprie strutture AVCPRECONNECTINFO per i plug esterni.

Deve essere chiamato in IRQL = PASSIVE_LEVEL.