DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT Rückruffunktion (dispmprt.h)

Artikel
02/26/2024

Die DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT-Funktion konfiguriert das angegebene geschützte Ausgabeobjekt.

Syntax

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

Parameter

[in] MiniportDeviceContext

Ein Handle für einen Kontextblock, der einem Grafikkarte zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

[in] ProtectedOutputHandle

Das Handle für ein geschütztes Ausgabeobjekt. Die DxgkDdiOPMCreateProtectedOutput-Funktion erstellt das geschützte Ausgabeobjekt und gibt das Handle an das Objekt zurück.

[in] Parameters

Ein Zeiger auf eine DXGKMDT_OPM_CONFIGURE_PARAMETERS-Struktur , die Parameter enthält, die zum Konfigurieren des geschützten Ausgabeobjekts verwendet werden, dessen Handle im Parameter ProtectedOutputHandle angegeben ist.

[in] AdditionalParametersSize

Die Größe der zusätzlichen Parameter in Bytes im Puffer, auf die von AdditionalParameters verwiesen wird. Bei der COPP-Emulation (Certified Output Protection Protocol) ist dies 0.

[in] AdditionalParameters

Ein Zeiger auf einen Puffer, der die zusätzlichen Parameter enthält, die zum Konfigurieren des geschützten Ausgabeobjekts verwendet werden, dessen Handle im Parameter ProtectedOutputHandle angegeben ist. Bei der COPP-Emulation ist dies NULL. Wenn der Parameter AdditionalParametersSize auf 0 festgelegt ist, wird AdditionalParameters immer auf NULL festgelegt.

Rückgabewert

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat das geschützte Ausgabeobjekt erfolgreich konfiguriert.
STATUS_NO_MEMORY	DxgkDdiOPMConfigureProtectedOutput kann keinen Speicher zuordnen, der für den Abschluss erforderlich ist.

Diese Funktion kann auch andere Fehlercodes zurückgeben, die in Ntstatus.h definiert sind.

Hinweise

Das DirectX-Grafikkernsubsystem ruft DxgkDdiOPMGetInformation oder DxgkDdiOPMGetCOPPCompatibleInformation auf, um Informationen zur Ausgabe abzurufen, und ruft dann DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT ein oder mehrere Male auf, um die Ausgabe zu konfigurieren.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT sollte seitenfähig gemacht werden.