DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT função de retorno de chamada (dispmprt.h)

Artigo
02/23/2024

A função DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT configura o objeto de saída protegido fornecido.

Sintaxe

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

Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporta de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos DirectX.

[in] ProtectedOutputHandle

O identificador para um objeto de saída protegido. A função DxgkDdiOPMCreateProtectedOutput cria o objeto de saída protegido e retorna o identificador para o objeto .

[in] Parameters

Um ponteiro para uma estrutura DXGKMDT_OPM_CONFIGURE_PARAMETERS que contém parâmetros usados para configurar o objeto de saída protegido cujo identificador é especificado no parâmetro ProtectedOutputHandle .

[in] AdditionalParametersSize

O tamanho, em bytes, dos parâmetros adicionais no buffer apontado por AdditionalParameters. Para a emulação do COPP (Certified Output Protection Protocol), isso é 0.

[in] AdditionalParameters

Um ponteiro para um buffer que contém os parâmetros adicionais que são usados para configurar o objeto de saída protegido cujo identificador é especificado no parâmetro ProtectedOutputHandle . Para a emulação copp, isso é NULL. Se o parâmetro AdditionalParametersSize estiver definido como 0, AdditionalParameters sempre será definido como NULL.

Retornar valor

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	A função configurou com êxito o objeto de saída protegido.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput não pode alocar a memória necessária para que ela seja concluída.

Essa função também pode retornar outros códigos de erro definidos em Ntstatus.h.

Comentários

O subsistema de kernel de elementos gráficos DirectX chama DxgkDdiOPMGetInformation ou DxgkDdiOPMGetCOPPCompatibleInformation para recuperar informações sobre a saída e, em seguida, chama DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT uma ou mais vezes para configurar a saída.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT deve ser tornado paginável.