estructura DXVA_COPPStatusData (dxva.h)

Artículo
02/29/2024

La estructura DXVA_COPPStatusData contiene la información de estado devuelta de una consulta en una sesión de vídeo protegida asociada a un dispositivo COPP de DirectX VA.

Sintaxis

typedef struct _DXVA_COPPStatusData {
  GUID  rApp;
  ULONG dwFlags;
  ULONG dwData;
  ULONG ExtendedInfoValidMask;
  ULONG ExtendedInfoData;
} DXVA_COPPStatusData;

Miembros

rApp

Especifica un número aleatorio de 128 bits que se usa una vez. La aplicación solicitante genera este número aleatorio y se proporciona al controlador de visualización en el miembro rApp de la estructura DXVA_COPPStatusInput .

dwFlags

Especifica información de estado adicional que podría ser relevante para la aplicación que llama. El controlador de pantalla debe establecer dwFlags en el valor COPP_StatusNormal (0x00) del tipo de enumeración COPP_StatusFlags o en una combinación de ORed válida del siguiente COPP_StatusFlags:

COPP_LinkLost (0x01)
COPP_RenegotiationRequired (0x02)

dwData

Especifica los datos de estado de 32 bits que se devuelven de una de las siguientes solicitudes pasadas en el parámetro pInput de la función COPPQueryStatus .

DXVA_COPPQueryProtectionType

Devuelve una combinación ORed válida de los siguientes valores que indican los tipos disponibles de mecanismos de protección en el conector físico asociado a un dispositivo COPP:

COPP_ProtectionType_Unknown (0x80000000)
COPP_ProtectionType_None (0x00)
COPP_ProtectionType_HDCP (0x01)
COPP_ProtectionType_ACP (0x02)
COPP_ProtectionType_CGMSA (0x04)

DXVA_COPPQueryConnectorType

Devuelve uno de los valores siguientes del tipo de enumeración COPP_ConnectorType que identifica el tipo de conector físico que usa la sesión de vídeo:

COPP_ConnectorType_Unknown (-1)
COPP_ConnectorType_VGA (0)
COPP_ConnectorType_SVideo (1)
COPP_ConnectorType_CompositeVideo (2)
COPP_ConnectorType_ComponentVideo (3)
COPP_ConnectorType_DVI (4)
COPP_ConnectorType_HDMI (5)
COPP_ConnectorType_LVDS (6)
COPP_ConnectorType_TMDS (7)
COPP_ConnectorType_D_JPN (8)

El valor de COPP_ConnectorType_Internal (0x80000000) solo se combina con uno de los valores de tipo de conector anteriores para indicar que la conexión entre el adaptador de gráficos y el monitor de pantalla es permanente y no es accesible desde fuera de un gabinete que no es de usuario.

DXVA_COPPQueryLocalProtectionLevel

Devuelve el nivel de protección establecido actualmente para la sesión de vídeo. El valor de nivel de protección depende del tipo de protección especificado en el miembro StatusData de la estructura DXVA_COPPStatusInput . Para conocer los posibles niveles de protección, consulte el miembro ProtLevel de la estructura de DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryGlobalProtectionLevel

Devuelve el nivel de protección establecido actualmente para el conector físico. El valor de nivel devuelto debe reflejar el nivel de protección aplicado actualmente a través del conector, independientemente de cómo se indique al controlador que aplique el nivel de protección. Por ejemplo, si ACP se ha habilitado a través de la función ChangeDisplaySettingsEx de Win32 y no a través de la interfaz IAMCertifiedOutputProtection , el nivel de protección global que se devolvió a través de una llamada a la función COPPQueryStatus para el conector debe indicar que ACP estaba habilitado, aunque ACP no estaba habilitado a través de la interfaz IAMCertifiedOutputProtection .

El valor de nivel de protección depende del tipo de protección especificado en el miembro StatusData de la estructura DXVA_COPPStatusInput . Para conocer los posibles niveles de protección, consulte el miembro ProtLevel de la estructura de DXVA_COPPSetProtectionLevelCmdData .

DXVA_COPPQueryBusData

Devuelve uno de los siguientes valores del tipo de enumeración COPP_BusType que identifica el tipo de bus usado por el hardware gráfico asociado a un dispositivo COPP:

COPP_BusType_Unknown (0)
COPP_BusType_PCI (1)
COPP_BusType_PCIX (2)
COPP_BusType_PCIExpress (3)
COPP_BusType_AGP (4)

El valor de COPP_BusType_Integrated (0x80000000) solo se puede combinar con uno de los valores de tipo bus anteriores cuando ninguna de las señales de interfaz de comando y estado entre el adaptador de gráficos y otros subsistemas está disponible en un bus de expansión que usa una especificación disponible públicamente y un tipo de conector estándar. Los buses de memoria se excluyen de esta definición.

ExtendedInfoValidMask

Especifica un valor que indica los campos de bits válidos en el siguiente miembro ExtendedInfoData .

ExtendedInfoData

Especifica datos adicionales de 32 bits para el estado. No se usa actualmente.

Comentarios

El controlador de visualización devuelve información de estado a través del parámetro pOutput de COPPQueryStatus. La estructura DXVA_COPPStatusOutput describe la información de estado devuelta. El controlador de pantalla debe convertir la información de estado en un puntero a una estructura de DXVA_COPPStatusData y devolver la información de estado en el miembro COPPStatus de DXVA_COPPStatusOutput.

Requisitos

Requisito	Value
Cliente mínimo compatible	Esta estructura solo se aplica a Windows Server 2003 con SP1 y versiones posteriores, y Windows XP con SP2 y versiones posteriores.
Encabezado	dxva.h (include Dxva.h)