IOPMVideoOutput::Configure-Methode (opmapi.h)

Konfiguriert eine Videoausgabe. Diese Methode sendet einen OPM-Befehl (Output Protection Manager) oder einen COPP-Befehl (Certified Output Protection Protocol) an den Treiber.

Syntax

HRESULT Configure(
  [in] const OPM_CONFIGURE_PARAMETERS *pParameters,
  [in] ULONG                          ulAdditionalParametersSize,
  [in] const BYTE                     *pbAdditionalParameters
);

Parameter

[in] pParameters

Zeiger auf eine OPM_CONFIGURE_PARAMETERS Struktur, die den Befehl enthält. Eine Liste der OPM-Befehle finden Sie unter OPM-Befehle.

[in] ulAdditionalParametersSize

Die Größe des pbAdditionalParameters-Puffers in Bytes.

[in] pbAdditionalParameters

Zeiger auf einen Puffer, der zusätzliche Informationen für den Befehl enthält.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode entspricht der IAMCertifiedOutputProtection::P rotectionCommand-Methode in COPP.

Diese Methode unterstützt sowohl OPM-Semantik als auch COPP-Semantik. COPP-Semantik wird aus Gründen der Abwärtskompatibilität unterstützt. Neue Anwendungen sollten OPM-Semantik verwenden.

OPM-Semantik

Für einige OPM-Befehle müssen zusätzliche Konfigurationsinformationen im PbAdditionalParameters-Parameter übergeben werden. Der Parameter ulAdditionalParametersSize gibt die Größe der zusätzlichen Daten an.

COPP-Semantik

Der pbAdditionalParameters-Parameter muss NULL und ulAdditionalParametersSize null sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	opmapi.h

Weitere Informationen

IOPMVideoOutput

Ausgabeschutz-Manager