DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT configura l'oggetto di output protetto specificato.

Sintassi

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
)
{...}

Parametri

[in] MiniportDeviceContext

Handle per un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema kernel della grafica DirectX.

[in] ProtectedOutputHandle

Handle di un oggetto di output protetto. La funzione DxgkDdiOPMCreateProtectedOutput crea l'oggetto di output protetto e restituisce l'handle all'oggetto.

[in] Parameters

Puntatore a una struttura di DXGKMDT_OPM_CONFIGURE_PARAMETERS che contiene parametri utilizzati per configurare l'oggetto di output protetto il cui handle viene specificato nel parametro ProtectedOutputHandle.

[in] AdditionalParametersSize

Dimensione, in byte, dei parametri aggiuntivi nel buffer a cui punta AdditionalParameters. Per l'emulazione COPP (Certified Output Protection Protocol), si tratta di 0.

[in] AdditionalParameters

Puntatore a un buffer che contiene i parametri aggiuntivi utilizzati per configurare l'oggetto di output protetto il cui handle viene specificato nel parametro ProtectedOutputHandle. Per l'emulazione COPP, si tratta di NULL. Se il parametro AdditionalParametersSize è impostato su 0, AdditionalParameters è sempre impostato su NULL.

Valore restituito

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha configurato correttamente l'oggetto di output protetto.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput non può allocare memoria necessaria per il completamento.

Questa funzione potrebbe restituire anche altri codici di errore definiti in Ntstatus.h.

Osservazioni

Il sottosistema kernel della grafica DirectX chiama DxgkDdiOPMGetInformation o DxgkDdiOPMGetCOPPCompatibleInformation per recuperare informazioni sull'output e quindi chiama DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT una o più volte per configurare l'output.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT deve essere reso pageable.