KsCreateDevice, fonction (ks.h)
La fonction KsCreateDevice crée un appareil AVStream.
Syntaxe
KSDDKAPI NTSTATUS KsCreateDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor,
[in] ULONG ExtensionSize,
[out, optional] PKSDEVICE *Device
);
Paramètres
[in] DriverObject
Pointeur vers l’objet pilote WDM du minidriver.
[in] PhysicalDeviceObject
Pointeur vers l’objet d’appareil physique WDM pour l’appareil que vous souhaitez créer sous AVStream.
[in, optional] Descriptor
Pointeur vers un descripteur d’appareil qui décrit les caractéristiques de l’appareil en cours de création. Si l’appelant ne spécifie pas ce paramètre facultatif, AVStream crée un appareil avec des caractéristiques par défaut et aucune fabrique de filtre associée.
[in] ExtensionSize
Ce paramètre contient la taille de l’extension d’appareil. Si cette valeur est égale à zéro, la taille d’extension par défaut est utilisée. Si ce n’est pas le cas, il doit être au moins sizeof (KSDEVICE_HEADER).
[out, optional] Device
Pointeur vers un emplacement de mémoire qui contient l’adresse de la structure KSDEVICE créée. facultatif.
Valeur retournée
Retourne STATUS_SUCCESS si l’appareil est correctement créé. Sinon, elle retourne un code d’erreur approprié.
Remarques
Normalement, le minidriver n’appelle pas cette fonction directement. Au lieu de cela, KsCreateDevice est appelé par le gestionnaire AddDevice par défaut, KsAddDevice. Étant donné que KsAddDevice effectue un appel interne à KsCreateDevice, les pilotes qui appellent KsCreateDevice ne doivent pas appeler KsAddDevice séparément.
Un minidriver qui appelle directement KsCreateDevice ne doit pas utiliser KsInitializeDriver. Si le minidriver n’appelle pas KsInitializeDriver, il doit fournir son propre rappel AddDevice . Le minidriver peut ensuite appeler KsCreateDevice à partir de ce rappel AddDevice .
Si aucune KSDEVICE_DESCRIPTOR n’est fournie, AVStream crée un appareil avec les caractéristiques par défaut et aucune fabrique de filtre associée. Si une KSDEVICE_DESCRIPTOR est fournie et contient une table KSDEVICE_DISPATCH avec un dispatch create, la dispatch create est appelée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |