DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT funzione di callback (dispmprt.h)

Articolo
02/26/2024

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 di 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 del kernel grafico 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 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), questo è 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 viene 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 anche restituire altri codici di errore definiti in Ntstatus.h.

Commenti

Il sottosistema del kernel grafico 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 paginabile.