structure KSOBJECT_CREATE_ITEM (ks.h)
La structure KSOBJECT_CREATE_ITEM est utilisée pour rechercher la chaîne passée à une demande de création.
Syntaxe
typedef struct {
PDRIVER_DISPATCH Create;
PVOID Context;
UNICODE_STRING ObjectClass;
PSECURITY_DESCRIPTOR SecurityDescriptor;
ULONG Flags;
} KSOBJECT_CREATE_ITEM, *PKSOBJECT_CREATE_ITEM;
Membres
Create
Contient la fonction create dispatch pour cette classe d’objet de base particulière. Consultez DRIVER_OBJECT pour connaître la signature de ce type de fonction.
Context
Pointe vers une mémoire tampon qui peut être utilisée pour stocker des informations de contexte spécifiques au type d’objet. Pour plus d’informations, consultez la section Remarques ci-dessous.
ObjectClass
Pointe vers une chaîne Unicode qui identifie la classe d’objet. Il s’agit de la chaîne utilisée pour s’inscrire auprès de PnP pour une classe particulière d’objet prise en charge par cet appareil.
SecurityDescriptor
Contient un pointeur vers un SECURITY_DESCRIPTOR pour ce type d’objet, sinon NULL. Si la sécurité est utilisée, celle-ci doit être libérée lorsque le type d’objet n’est plus utilisé. Cela doit utiliser la mémoire du pool et ne peut pas être partagé, car il peut être remplacé. Si cette modification est apportée, l’élément Flags est mis à jour. facultatif.
Flags
Spécifie le type de demande. Les indicateurs peuvent avoir les valeurs répertoriées dans le tableau suivant.
| Indicateur | Description |
|---|---|
| KSCREATE_ITEM_SECURITYCHANGED | Indique que le descripteur de sécurité sur ce type d’objet a été modifié et doit être conservé. |
| KSCREATE_ITEM_WILDCARD | Indique que cet élément de création représente un carte générique utilisé pour toutes les demandes de création qui ne correspondent à aucun autre élément de création. L’ordre de l’entrée de carte générique dans la liste des éléments de création n’est pas pertinent. Une seule entrée de carte générique est valide dans une liste d’éléments de création. |
| KSCREATE_ITEM_NOPARAMETERS | Indique que cet élément de création n’autorise aucun paramètre à passer et échoue s’il y en a. Normalement, les paramètres de création sont transmis au gestionnaire de création. Il ne peut pas être utilisé avec un indicateur de carte générique. |
Remarques
Un pointeur vers la structure KSOBJECT_CREATE_ITEM est placé dans le membre DriverContext de Irp-Tail.Overlay> avant la création de l’objet. Vous pouvez accéder à ce pointeur à l’aide de la macro KSCREATE_ITEM_IRP_STORAGE. Cette macro et les macros associées sont incluses dans ks.h.
Le minidriver peut récupérer ce pointeur lors de la création d’un objet pour examiner le champ Contexte .
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ks.h (inclure Ks.h) |