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 zu erstellenden Geräts beschreibt. Wenn der Aufrufer diesen optionalen Parameter nicht angibt, erstellt AVStream ein Gerät mit Standardeigenschaften und ohne zugeordnete Filterfabriken.
[in] ExtensionSize
Dieser Parameter enthält die Größe der Geräteerweiterung. Wenn dies 0 ist, wird die Standarderweiterungsgröße verwendet. Andernfalls muss es mindestens sizeof (KSDEVICE_HEADER) sein.
[out, optional] Device
Ein Zeiger auf einen Speicherspeicherort, der die Adresse der erstellten KSDEVICE-Struktur enthält. Optional.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn das Gerät erfolgreich erstellt wurde. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.
Hinweise
Normalerweise ruft der Minidriver diese Funktion nicht direkt auf. Stattdessen wird KsCreateDevice vom Standardmäßigen AddDevice-HandlerKsAddDevice aufgerufen. Da KsAddDevice einen internen Aufruf von KsCreateDevice ausgibt, sollten Treiber, die KsCreateDevice aufrufen, KsAddDevice nicht separat aufrufen.
Ein Minidriver, der KsCreateDevice direkt aufruft , sollte KsInitializeDriver nicht verwenden. Wenn der Minidriver KsInitializeDriver nicht aufruft, sollte er stattdessen einen eigenen AddDevice-Rückruf bereitstellen. Der Minidriver kann dann KsCreateDevice über diesen AddDevice-Rückruf aufrufen.
Wenn kein KSDEVICE_DESCRIPTOR bereitgestellt wird, erstellt AVStream ein Gerät mit den Standardeigenschaften und ohne zugeordnete 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |