KsCreateDevice-Funktion (ks.h)
Die KsCreateDevice--Funktion erstellt ein AVStream-Gerät.
Syntax
KSDDKAPI NTSTATUS KsCreateDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor,
[in] ULONG ExtensionSize,
[out, optional] PKSDEVICE *Device
);
Parameter
[in] DriverObject
Ein Zeiger auf das WDM-Treiberobjekt des Minidrivers.
[in] PhysicalDeviceObject
Ein Zeiger auf das physische WDM-Geräteobjekt für das Gerät, das Sie unter AVStream erstellen möchten.
[in, optional] Descriptor
Ein Zeiger auf einen Gerätedeskriptor, der die Merkmale des erstellten Geräts beschreibt. Wenn der Aufrufer diesen optionalen Parameter nicht angibt, erstellt AVStream ein Gerät mit Standardmerkmalen und keine zugeordneten Filterfabriken.
[in] ExtensionSize
Dieser Parameter enthält die Größe der Geräteerweiterung. Wenn dies null ist, wird die Standarderweiterungsgröße verwendet. Wenn dies nicht der Dereins ist, muss es mindestens eine Größe aufweisen (KSDEVICE_HEADER).
[out, optional] Device
Ein Zeiger auf einen Speicherspeicherort, der die Adresse der erstellten KSDEVICE--Struktur enthält. Wahlfrei.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn das Gerät erfolgreich erstellt wurde. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.
Bemerkungen
Normalerweise ruft der Minidriver diese Funktion nicht direkt auf. Stattdessen wird KsCreateDevice standardmäßig AddDevice Handler, KsAddDeviceaufgerufen. Da KsAddDevice einen internen Aufruf an KsCreateDevicevorgibt, sollten Treiber, die KsCreateDevice aufrufen, nicht separat KsAddDevice aufrufen.
Ein Minidriver, der KsCreateDevice aufruft, sollte nicht KsInitializeDriver-verwenden. Wenn der Minidriver nicht KsInitializeDriver-aufruft, sollte er stattdessen einen eigenen AddDevice- Rückruf bereitstellen. Der Minidriver kann dann KsCreateDevice von diesem AddDevice Rückruf aufrufen.
Wenn keine KSDEVICE_DESCRIPTOR bereitgestellt wird, erstellt AVStream ein Gerät mit den Standardmerkmalen und keine zugeordneten Filterfabriken. Wenn ein KSDEVICE_DESCRIPTOR angegeben wird und eine KSDEVICE_DISPATCH Tabelle mit einem Create Dispatch enthält, wird der create dispatch aufgerufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | PASSIVE_LEVEL |