Método IAMCertifiedOutputProtection::KeyExchange (strmif.h)

Artículo
07/28/2023

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método KeyExchange devuelve el certificado del controlador de gráficos.

Sintaxis

HRESULT KeyExchange(
  [out] GUID  *pRandom,
  [out] BYTE  **VarLenCertGH,
  [out] DWORD *pdwLengthCertGH
);

Parámetros

[out] pRandom

Recibe un número aleatorio de 128 bits, generado por el controlador de gráficos. Use este valor en el método IAMCertifiedOutputProtection::SessionSequenceStart .

[out] VarLenCertGH

Recibe un puntero a un búfer que contiene el certificado del controlador de gráficos. El método asigna la memoria para el búfer. El autor de la llamada debe liberar la memoria llamando a CoTaskMemFree.

[out] pdwLengthCertGH

Recibe la longitud del búfer devuelto en VarLenCertGH.

Valor devuelto

Devuelve un valor HRESULT. Estos son algunos de los valores posibles.

Código devuelto	Descripción
S_OK	Correcto.
E_UNEXPECTED	Estado no válido. Posiblemente, la aplicación pasó datos inesperados o llamó a los métodos IAMCertifiedOutputProtection en el orden incorrecto. Si se produce este error, la aplicación debe liberar la instancia actual de VMR.
VFW_E_NO_COPP_HW	El dispositivo de pantalla no es compatible con COPP; o vmr aún no se ha conectado a un dispositivo de pantalla.
ERROR_GRAPHICS_NO_MONITORS_CORRESPOND_TO_DISPLAY_DEVICE	Ningún monitor corresponde al dispositivo de visualización. Este error puede producirse si cambia el modo de presentación; o el usuario desactiva un monitor o quita un monitor.

Observaciones

El certificado del controlador de gráficos contiene la clave de cifrado pública del controlador.

Si este método devuelve E_UNEXPECTED, la aplicación debe crear una nueva sesión copP mediante la liberación de VMR, la creación de una nueva instancia de VMR y la llamada KeyExchange de nuevo en la nueva instancia.

Requisitos


Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

IAMCertifiedOutputProtection (Interfaz)

Uso del Protocolo de protección de salida certificada (COPP)

Compartir a través de