AVC_FUNCTION_GET_CONNECTINFO

Articolo
06/15/2023

Il codice della funzione AVC_FUNCTION_GET_CONNECT_INFO ottiene la struttura AVCPRECONNECTINFO per ogni ID pin (offset da zero).

Blocco dello stato I/O

Se ha 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 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 oltre l'ambito del protocollo AV/C.

Commenti

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

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PRECONNECT_INFO PreConnectInfo;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

Di seguito sono riportati i membri della struttura AVC_PRECONNECT_INFO:

typedef struct _AVC_PRECONNECT_INFO {
    IN ULONG PinId
    OUT AVCPRECONNECTINFO ConnectInfo;
} AVC_PRECONNECT_INFO, *PAVC_PRECONNECT_INFO;

Requisiti

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

AVC_MULTIFUNC_IRB Input

Common
Il sottomember della funzione di questo membro deve essere impostato su AVC_FUNCTION_GET_CONNECTINFO dall'enumerazione AVC_FUNCTION .

ConnectInfo
Specifica le informazioni di connessione per il dispositivo AV/C.

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

Un driver subunit deve usare questa funzione se è responsabile della creazione degli intervalli di dati inclusi nella struttura KSPIN_DESCRIPTOR. La struttura AVCPRECONNECTINFO viene aggiunta al membro DataRanges per le connessioni esterne al PC.

Questa operazione deve essere chiamata in IRQL = PASSIVE_LEVEL.