Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IKsControl Schnittstelle ist eine COM-Formatschnittstelle, die auf AVStream-Filtern und -Pins implementiert ist. Es ermöglicht Clients im Kernelmodus den Zugriff auf AVStream-Automatisierungsobjekte (Eigenschaften, Methoden und Ereignisse).
Informationen zum Kernelmodusäquivalent dieser Schnittstelle finden Sie in der IKsControl (ksproxy.h) Kernelstream-Proxy-COM-Schnittstelle.
Erbschaft
Die IKsControl Schnittstelle erbt von der IUnknown Schnittstelle.
Methodik
Die IKsControl--Schnittstelle verfügt über diese Methoden.
IKsControl::KsEvent Die IKsControl::KsEvent-Methode aktiviert oder deaktiviert ein Ereignis zusammen mit anderen definierten Supportvorgängen, die für einen Ereignissatz verfügbar sind. |
IKsControl::KsMethod Die IKsControl::KsMethod-Methode sendet eine Methode an ein KS-Objekt zusammen mit allen anderen definierten Supportvorgängen, die für einen Methodensatz verfügbar sind. |
IKsControl::KsProperty Die IKsControl::KsProperty-Methode legt eine Eigenschaft fest oder ruft Eigenschaftsinformationen zusammen mit allen anderen definierten Supportvorgängen ab, die für einen Eigenschaftensatz verfügbar sind. |
Bemerkungen
HINWEIS: Die IKsControl Schnittstelle sollte nicht mit KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY Eigenschaften unter KSPROPERTYSETID_ExtendedCameraControl Eigenschaftensatz verwendet werden. Verwenden Sie bitte IMFExtendedCameraController.
Minidriver rufen in der Regel die IKsControl Schnittstelle über einen Aufruf von KsPinGetConnectedFilterInterface oder KsPinGetConnectedPinInterfaceab. Da es sich um eine COM-Schnittstelle handelt, ruft der Funktionsaufruf zum Abrufen dieser Schnittstelle die QueryInterface--Methode auf, die wiederum die AddRef--Methode aufruft. Daher muss der Minidriver diese Schritte nicht ausführen.
Sobald der Client jedoch mit der IKsControl Schnittstelle fertig ist, muss er IKsControl- mit einem Aufruf der Release-Methode freigeben.
Minidriver, die in C geschrieben wurden, bearbeiten die IKsControl Schnittstelle als Struktur, die einen Zeiger auf eine Tabelle mit Funktionen anstelle einer abstrakten C++-Basisklasse enthält.
Ein Client, der in C++ geschrieben wurde, führt folgende Aktionen aus:
IKsControl *Control;
if (NT_SUCCESS (
KsPinGetConnectedPinInterface (
Pin,
IID_IKsControl,
(PVOID *)&Control) )
) {
Control -> KsProperty (...);
Control -> Release ();
}
Ein in C geschriebener Client verwendet jedoch stattdessen diesen Code:
IKsControl *Control;
If (NT_SUCCESS (
KsPinGetConnectedPinInterface (
Pin,
IID_IKsControl,
(PVOID *)&Control) )
) {
Control -> lpVtbl -> KsProperty (...);
Control -> lpVtbl -> Release ();
}
Weitere Informationen finden Sie unter AVStream Overview.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Fenster |
Header- | ks.h (enthalten Ks.h) |