DXGKDDI_OPM_CREATE_PROTECTED_OUTPUT funzione di callback (dispmprt.h)

Articolo
02/23/2024

La funzione DxgkDdiOPMCreateProtectedOutput crea un nuovo oggetto di output protetto con la semantica COPP (Certified Output Protection Protocol) o OPM.

Sintassi

DXGKDDI_OPM_CREATE_PROTECTED_OUTPUT DxgkddiOpmCreateProtectedOutput;

NTSTATUS DxgkddiOpmCreateProtectedOutput(
  [in]  PVOID MiniportDeviceContext,
  [in]  D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [in]  DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS NewVideoOutputSemantics,
  [out] PHANDLE NewProtectedOutputHandle
)
{...}

Parametri

[in] MiniportDeviceContext

Handle a un blocco di contesto associato a una scheda di visualizzazione. In precedenza, la funzione DxgkDdiAddDevice del driver del miniport visualizzato ha fornito questo handle al sottosistema del kernel grafico DirectX.

[in] VidPnTargetId

Intero che identifica in modo univoco la destinazione del video presente che corrisponde al nuovo oggetto di output protetto. Ogni destinazione del video presente deve corrispondere a un connettore di monitoraggio fisico. Se VidPnTargetId corrisponde a più connettori di monitoraggio fisico, DxgkDdiOPMCreateProtectedOutput deve restituire il codice di errore STATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLED o STATUS_GRAPHICS_OPM_THEATER_MODE_ENABLED.

[in] NewVideoOutputSemantics

Valore DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS tipizzato che determina se il nuovo output protetto ha la semantica COPP o OPM.

[out] NewProtectedOutputHandle

Puntatore a una variabile che riceve l'handle al nuovo oggetto di output protetto se DxgkDdiOPMCreateProtectedOutput restituisce correttamente. Il sottosistema kernel della grafica DirectX passa questo handle nelle chiamate al miniport driver dxgkDdiOPMGetRandomNumber, DxgkDdiOPMSetSigningKeyAndSequenceNumbers DxgkDdiOPMGetInformation, DxgkDdiOPMGetInformation, DxgkDdiOPMGetCOPPCompatibleInformation, DxgkDdiOPMConfigureProtectedOutput e DxgkDdiOPMDestroyProtectedOutput.

Se DxgkDdiOPMCreateProtectedOutput ha esito negativo, il valore della variabile è invariato.

Valore restituito

DxgkDdiOPMCreateProtectedOutput restituisce uno dei valori seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha creato correttamente un nuovo oggetto di output protetto.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	Il driver miniport di visualizzazione non supporta OPM perché il fornitore dell'hardware non ha mai firmato il contratto di licenza OPM o l'hardware grafico del driver miniport non è conforme alle regole OPM.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Il driver miniport visualizzato non supporta COPP perché il fornitore hardware non ha mai firmato il contratto di licenza COPP o l'hardware grafico del driver miniport non è conforme alle regole COPP.
STATUS_NO_MEMORY	DxgkDdiOPMCreateProtectedOutput non può allocare memoria necessaria per il completamento.
STATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLED	DxgkDdiOPMCreateProtectedOutput non è stato possibile creare un output protetto perché la destinazione del video presente è in modalità di estensione. Quando la destinazione del video presente è in modalità di estensione, corrisponde a più connettori di monitoraggio fisico e ogni connettore visualizza una parte separata del buffer frame. Per un diagramma di come il driver miniport visualizzato implementa in genere la modalità di estensione, vedere la sezione Osservazioni. Il driver miniport di visualizzazione informa il sistema operativo su come il buffer del frame corrisponde a un determinato monitoraggio. La metà sinistra del buffer di frame viene visualizzata su un monitor e la metà destra del buffer di frame viene visualizzata nell'altro monitor.
STATUS_GRAPHICS_OPM_THEATER_MODE_ENABLED	DxgkDdiOPMCreateProtectedOutput non è stato possibile creare un output protetto perché il video presente è in modalità teatro. Quando la destinazione del video presente è in modalità teatro, corrisponde a due connettori di monitoraggio fisico; un connettore visualizza l'intero buffer frame e l'altro connettore visualizza solo parte del buffer di frame. La modalità teatro è nota anche come modalità mirror. Per un diagramma di come il driver miniport visualizzato implementa in genere la modalità teatro, vedere la sezione Osservazioni. Il driver miniport di visualizzazione informa il sistema operativo su come il buffer del frame corrisponde a un determinato monitoraggio. L'intero buffer frame viene visualizzato su un monitor e viene visualizzata solo parte del buffer frame nell'altro monitor.

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

Commenti

Nella figura seguente viene illustrato come il driver miniport visualizzato implementa in genere la modalità di estensione.

Diagramma che illustra la modalità di estensione

Nella figura seguente viene illustrato come il driver miniport visualizzato implementa in genere la modalità teatro. Diagramma che illustra la modalità teatro