DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT callback function

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 codeDescription
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

Target platform

Header

Dispmprt.h (include Dispmprt.h)

IRQL

PASSIVE_LEVEL (see Remarks section)

See also

DxgkDdiAddDevice
DxgkDdiOPMCreateProtectedOutput
DxgkDdiOPMGetCOPPCompatibleInformation
DxgkDdiOPMGetInformation
DXGKMDT_OPM_CONFIGURE_PARAMETERS

 

 

Send comments about this topic to Microsoft

Show: