Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La propriété CODECAPI_ALLSETTINGS est utilisée pour transmettre un bloc de données généré par minidriver.
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
| Oui | Oui | Filtre | KSPROPERTY | PVOID |
La valeur de propriété (données d’opération) est de type PVOID, qui est un pointeur vers une mémoire tampon en mode utilisateur pour le bloc de données généré par minidriver.
Commentaires
Sur une propriété, obtenez l’appel :
Si une application effectue un appel get property avec une mémoire tampon de longueur zéro, le minidriver doit retourner STATUS_BUFFER_OVERFLOW et spécifier la taille de mémoire tampon requise dans le champ Irp->IoStatus.Information. Si la mémoire tampon de longueur est différente de zéro, le minidriver doit retourner STATUS_BUFFER_TOO_SMALL si la mémoire tampon fournie est trop petite pour le bloc de données, sinon le minidriver packs ses paramètres dans un bloc de données qui peut être restauré ultérieurement.
Il incombe au minidriver d’ajouter des vérifications d’intégrité des données aux données, telles qu’un GUID unique pour indiquer que le minidriver a généré les données, une vérification de redondance cyclique (CRC) et une longueur d’en-tête.
Les données retournées doivent être légères et contiennent uniquement des informations nécessaires pour reconstruire les paramètres actuels.
Les applications utilisent cette propriété pour undos multiniveau, stockés avec leurs projets, et ainsi de suite.
Sur un appel de jeu de propriétés :
Le minidriver doit vérifier l’intégrité des données et vérifier que la taille du bloc de données est inférieure à la taille maximale des données (par exemple, rejeter quoi que ce soit sur une certaine taille). Il doit également vérifier le CRC et la longueur de l’en-tête. Le minidriver doit également mettre en cache toutes les modifications à propager pour CODECAPI_CURRENTCHANGELIST.
Spécifications
En-têtes : déclaré dans ksmedia.h. Incluez ksmedia.h.