This topic has not yet been rated - Rate this topic

DxgkDdiOPMConfigureProtectedOutput routine

The DxgkDdiOPMConfigureProtectedOutput function configures the given protected output object.

Syntax


DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkDdiOPMConfigureProtectedOutput;

NTSTATUS DxgkDdiOPMConfigureProtectedOutput(
  _In_  PVOID MiniportDeviceContext,
  _In_  HANDLE ProtectedOutputHandle,
  _In_  const PDXGKMDT_OPM_CONFIGURE_PARAMETERS Parameters,
  _In_  ULONG AdditionalParametersSize,
  _In_  const PVOID AdditionalParameters
)
{ ... }

Parameters

MiniportDeviceContext [in]: A handle to a context block associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.
ProtectedOutputHandle [in]: The handle to a protected output object. The DxgkDdiOPMCreateProtectedOutput function creates the protected output object and returns the handle to the object.
Parameters [in]: A pointer to a DXGKMDT_OPM_CONFIGURE_PARAMETERS structure that contains parameters that are used to configure the protected output object whose handle is specified in the ProtectedOutputHandle parameter.
AdditionalParametersSize [in]: The size, in bytes, of the additional parameters in the buffer that is pointed to by AdditionalParameters. For Certified Output Protection Protocol (COPP) emulation, this is 0.
AdditionalParameters [in]: A pointer to a buffer that holds the additional parameters that are used to configure the protected output object whose handle is specified in the ProtectedOutputHandle parameter. For COPP emulation, this is NULL. If the AdditionalParametersSize parameter is set to 0, AdditionalParameters is always set to NULL.

Return value

DxgkDdiOPMConfigureProtectedOutput returns one of the following values:

Return code	Description
STATUS_SUCCESS	The function successfully configured the protected output object.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput cannot allocate memory required for it to complete.

This function might also return other error codes that are defined in Ntstatus.h.

Remarks

The DirectX graphics kernel subsystem calls DxgkDdiOPMGetInformation or DxgkDdiOPMGetCOPPCompatibleInformation to retrieve information about the output and then calls DxgkDdiOPMConfigureProtectedOutput one or more times to configure the output.

DxgkDdiOPMConfigureProtectedOutput should be made pageable.

Requirements