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 |