AVC_FUNCTION_GET_UNIQUE_ID
El código de función AVC_FUNCTION_GET_UNIQUE_ID obtiene el identificador único de la unidad AV/C.
Bloque de estado de entrada/salida
Si se ejecuta correctamente, el controlador de protocolo AV/C establece Irp-IoStatus.Status> en STATUS_SUCCESS.
Entre los posibles otros valores devueltos se incluyen:
| Valor devuelto | Descripción |
|---|---|
| STATUS_TIMEOUT | Se realizó la solicitud, pero no se recibió ninguna respuesta antes de que se completara todo el tiempo de espera y se completara el procesamiento de reintento. |
| STATUS_REQUEST_ABORTED | Anule inmediatamente cuando se STATUS_REQUEST_ABORTED el estado de finalización de IRP. Esto indica que el dispositivo se ha quitado o ya no está disponible en el bus 1394. |
| ESTADO_* | Cualquier otro código de retorno indica que se produjo un error o advertencia que estaba fuera del ámbito del protocolo AV/C. |
Comentarios
Esta función usa el miembro UniqueID de la estructura AVC_MULTIFUNC_IRB como se muestra a continuación.
typedef struct _AVC_MULTIFUNC_IRB {
AVC_IRB Common;
union {
.
.
.
AVC_UNIQUE_ID UniqueID;
.
.
.
};
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;
A continuación se muestran los miembros de la estructura AVC_UNIQUE_ID:
typedef struct _AVC_UNIQUE_ID {
OUT GUID DeviceID;
} AVC_UNIQUE_ID, *PAVC_UNIQUE_ID;
Requisitos
Encabezados: Declarado en avc.h. Incluya avc.h.
entrada de AVC_MULTIFUNC_IRB
Común
El submembrado Function de este miembro debe establecerse en AVC_FUNCTION_GET_UNIQUE_ID de la enumeración AVC_FUNCTION.
Uniqueid
Especifica un GUID que representa la unidad en su conjunto. Todas las subuniciones dentro de la misma unidad comparten el mismo GUID. No hay dos unidades que compartan el mismo GUID.
Las instancias virtuales de avc.sysno admiten este código de función.
El controlador de subbúsito usa esta función si debe notificar el GUID del dispositivo a una aplicación de control (una aplicación que debe saber cuál de las muchas instancias del controlador de subbúnit pertenecen a la misma unidad) o si está creando sus propias estructuras AVCPRECONNECTINFO para los enchufes externos.
Se debe llamar a en IRQL = PASSIVE_LEVEL.