KsCreateDevice-Funktion (ks.h)

Artikel
02/29/2024

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