DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT función de devolución de llamada (dispmprt.h)

Artículo
02/26/2024

La función DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT configura el objeto de salida protegido especificado.

Sintaxis

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkddiOpmConfigureProtectedOutput;

NTSTATUS DxgkddiOpmConfigureProtectedOutput(
  [in] PVOID MiniportDeviceContext,
  [in] HANDLE ProtectedOutputHandle,
  [in] const DXGKMDT_OPM_CONFIGURE_PARAMETERS *Parameters,
  [in] ULONG AdditionalParametersSize,
  [in] const VOID *AdditionalParameters
)
{...}

Parámetros

[in] MiniportDeviceContext

Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX.

[in] ProtectedOutputHandle

Identificador de un objeto de salida protegido. La función DxgkDdiOPMCreateProtectedOutput crea el objeto de salida protegido y devuelve el identificador al objeto .

[in] Parameters

Puntero a una estructura de DXGKMDT_OPM_CONFIGURE_PARAMETERS que contiene parámetros que se usan para configurar el objeto de salida protegido cuyo identificador se especifica en el parámetro ProtectedOutputHandle .

[in] AdditionalParametersSize

Tamaño, en bytes, de los parámetros adicionales del búfer al que apunta AdditionalParameters. Para la emulación del Protocolo de protección de salida certificada (COPP), es 0.

[in] AdditionalParameters

Puntero a un búfer que contiene los parámetros adicionales que se usan para configurar el objeto de salida protegido cuyo identificador se especifica en el parámetro ProtectedOutputHandle . En el caso de la emulación de COPP, esto es NULL. Si el parámetro AdditionalParametersSize se establece en 0, AdditionalParameters siempre se establece en NULL.

Valor devuelto

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT devuelve uno de los valores siguientes:

Código devuelto	Descripción
STATUS_SUCCESS	La función configuró correctamente el objeto de salida protegido.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput no puede asignar memoria necesaria para que se complete.

Esta función también puede devolver otros códigos de error definidos en Ntstatus.h.

Comentarios

El subsistema del kernel de gráficos de DirectX llama a DxgkDdiOPMGetInformation o DxgkDdiOPMGetCOPPCompatibleInformation para recuperar información sobre la salida y, a continuación, llama a DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT una o varias veces para configurar la salida.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT debe ser paginable.