USBCAMD_ControlVendorCommand, fonction (usbcamdi.h)

Article
03/01/2024

La fonction USBCAMD_ControlVendorCommand envoie des commandes spécifiques au fournisseur au canal de contrôle.

Syntaxe

NTSTATUS USBCAMD_ControlVendorCommand(
  [in]                PVOID                      DeviceContext,
  [in]                UCHAR                      Request,
  [in]                USHORT                     Value,
  [in]                USHORT                     Index,
  [in, out, optional] PVOID                      Buffer,
  [in, out]           PULONG                     BufferLength,
  [in]                BOOLEAN                    GetData,
  [in, optional]      PCOMMAND_COMPLETE_FUNCTION CommandComplete,
  [in, optional]      PVOID                      CommandContext
);

Paramètres

[in] DeviceContext

Pointeur vers le contexte spécifique à l’appareil.

[in] Request

Spécifie la valeur du champ Requête pour la commande vendor.

[in] Value

Spécifie la valeur du champ Valeur pour la commande vendor.

[in] Index

Spécifie la valeur du champ Index pour la commande vendor.

[in, out, optional] Buffer

Pointeur vers une mémoire tampon de données si la commande contient des données. Si la commande n’a pas de données, cette valeur est NULL.

[in, out] BufferLength

Pointeur vers la valeur de longueur de la mémoire tampon. La longueur de la mémoire tampon est exprimée en octets. Si la valeur de Buffer est NULL, BufferLength peut également être NULL.

[in] GetData

GetData indique que les données ont été envoyées de l’appareil à l’hôte.

[in, optional] CommandComplete

Pointeur vers un minidriver d’appareil photo défini CommandCompleteFunction, qui est appelé lorsque la lecture ou l’écriture en bloc est terminée. Cette valeur peut être NULL.

[in, optional] CommandContext

Pointeur vers un bloc de mémoire, qui est passé en tant qu’argument au minidriver de l’appareil photo défini par CommandCompleteFunction.

Valeur retournée

USBCAMD_ControlVendorCommand retourne le code NTSTATUS à partir de la commande vendor.

Voici d’autres codes d’erreur possibles :

Code de retour	Description
STATUS_PENDING	La commande vendor est différée.
STATUS_INSUFFICIENT_RESOURCES	Les ressources sont insuffisantes pour allouer la commande vendor.

Remarques

Cette fonction peut être appelée dans IRQL >= PASSIVE_LEVEL. Si la fonction est appelée au PASSIVE_LEVEL IRQL > , la commande est différée. Une fois l’opération terminée, le minidriver de l’appareil photo défini par CommandCompleteFunction est appelé et a passé la valeur dans l’argument CommandContext *.*

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	usbcamdi.h (incluez Usbcamdi.h)
Bibliothèque	Usbcamd2.lib
IRQL	Supérieur ou égal à PASSIVE_LEVEL (voir la section Remarques)

Voir aussi

CommandCompleteFunction

Partager via