DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// dispmprt.h
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
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT function configures the given protected output object.
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.
DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT 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.
The DirectX graphics kernel subsystem calls DxgkDdiOPMGetInformation or DxgkDdiOPMGetCOPPCompatibleInformation to retrieve information about the output and then calls DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT one or more times to configure the output.
DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT should be made pageable.
DxgkDdiOPMGetCOPPCompatibleInformation
DxgkDdiOPMCreateProtectedOutput
DXGKMDT_OPM_CONFIGURE_PARAMETERS