DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

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 zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers dieses Handle für das DirectX-Grafik-Kernel-Subsystem 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 ProtectedOutputHandle Parameter angegeben ist.

[in] AdditionalParametersSize

Die Größe der zusätzlichen Parameter im Puffer in Byte, auf die durch AdditionalParametersverwiesen 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 ProtectedOutputHandle--Parameter 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 gibt möglicherweise auch andere Fehlercodes zurück, die in Ntstatus.hdefiniert sind.

Bemerkungen

Das DirectX-Grafik-Kernelsubsystem ruft DxgkDdiOPMGetInformation oder DxgkDdiOPMGetCOPPCompatibleInformation auf, um Informationen über die Ausgabe abzurufen, und ruft dann DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT eine oder mehrere Male zum Konfigurieren der Ausgabe auf.

DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT sollte seitenfähig gemacht werden.