KsInitializeDevice-Funktion (ks.h)
Die KsInitializeDevice-Funktion wird von AVStream aufgerufen, um die AVStream-Geräteklasse in KsCreateDevice zu initialisieren.
Syntax
KSDDKAPI NTSTATUS KsInitializeDevice(
[in] PDEVICE_OBJECT FunctionalDeviceObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PDEVICE_OBJECT NextDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
Parameter
[in] FunctionalDeviceObject
Ein Zeiger auf eine DEVICE_OBJECT-Struktur , die das WDM-Funktionsgeräteobjekt für das zu initialisierende Gerät darstellt.
Normalerweise wird dies von einem IoCreateDevice-Aufruf zurückgegeben. Minidriver, die diese Funktion direkt aufrufen, sind für den Aufruf von IoCreateDevice und das Anfügen an den Gerätestapel verantwortlich.
[in] PhysicalDeviceObject
Ein Zeiger auf eine DEVICE_OBJECT-Struktur , die das objekt des physischen WDM-Geräts für das zu initialisierende Gerät darstellt.
[in] NextDeviceObject
Ein Zeiger auf die nächste DEVICE_OBJECT Struktur im Gerätestapel, die durch einen Aufruf von IoAttachDeviceToDeviceStack bestimmt wird.
[in, optional] Descriptor
Ein Zeiger auf eine KSDEVICE_DESCRIPTOR Struktur, die die Merkmale des zu initialisierenden Geräts beschreibt. Wenn dieser Parameter NULL ist, wird das Gerät mit den Standardmerkmalen initialisiert und verfügt über keine zugeordneten Filterfactorys.
Rückgabewert
KsInitializeDevice gibt STATUS_SUCCESS zurück, wenn das Gerät erfolgreich initialisiert wurde. Andernfalls wird ein geeigneter Fehlercode zurückgegeben.
Hinweise
Die meisten Minidriver rufen diese Funktion nicht direkt auf. Rufen Sie KsInitializeDevice nur auf, wenn Ihr Minidriver KsInitializeDriver nicht für die Initialisierung verwendet, AddDevice unabhängig behandelt und KsAddDevice oder KsCreateDevice im AddDevice-Handler nicht verwendet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |