AVCSTRM_READ

Article
06/15/2023

Le code de fonction AVCSTRM_READ est utilisé pour envoyer une mémoire tampon de données avcstrm.sys remplie de données à partir du flux spécifié.

Bloc d’état E/S

En cas de réussite, avcstrm.sys définit Irp-IoStatus.Status> sur STATUS_SUCCESS.

Les valeurs de retour d’erreur possibles sont les suivantes :

État de l’erreur	Description
STATUS_DEVICE_REMOVED	L’appareil correspondant à l’opération AVCSTRM_READ n’existe plus.
STATUS_CANCELLED	La demande n’a pas pu être effectuée.
STATUS_INVALID_PARAMETER	Un paramètre spécifié dans l’IRP est incorrect,
STATUS_INSUFFICIENT_RESOURCES	Il n’y avait pas suffisamment de ressources système pour effectuer la demande.
STATUS_PENDING	La demande a été reçue, mais nécessite un traitement supplémentaire. La routine d’achèvement des E/S gère la réponse finale.

entrée AVC_STREAM_REQUEST_BLOCK

SizeOfThisBlock, version et fonction
Utilisez la macro INIT_AVCSTRM_HEADER pour initialiser ces membres. Passez AVCSTRM_READ dans l’argument Request de la macro.

AVCStreamContext
Spécifie le contexte de flux (handle) retourné par un appel AVCSTRM_OPEN antérieur qui est la source de données pour l’opération de lecture.

BufferStruct
Spécifie la mémoire tampon dans laquelle l’opération de lecture doit placer les données.

Un pilote de sous-unité doit d’abord allouer un IRP et une structure de AVC_STREAM_REQUEST_BLOCK .

Ensuite, il doit utiliser la macro INIT_AVCSTRM_HEADER pour initialiser la structure AVC_STREAM_REQUEST_BLOCK, en passant AVCSTRM_READ comme argument Request à la macro.

Ensuite, le pilote de sous-unité définit le membre AVCStreamContext sur le contexte de flux (handle) du flux qui fournit les données à lire. Enfin, le pilote de sous-unité définit le membre BufferStruct de l’union CommandData qui décrit la mémoire tampon dans laquelle l’opération de lecture place les données.

Pour envoyer cette demande, une sous-unité envoie un IRP IRP_MJ_INTERNAL_DEVICE_CONTROL avec le membre IoControlCode de l’IRP défini sur IOCTL_AVCSTRM_CLASS et le membre Argument1 de l’IRP défini à la structure AVC_STREAM_REQUEST_BLOCK qui décrit l’opération de lecture à effectuer.

Cette commande se termine de manière asynchrone. Lorsqu’elle est terminée, la routine d’achèvement d’E/S définie dans l’IRP est appelée.

Ce code de fonction doit être appelé dans IRQL = PASSIVE_LEVEL.

Commentaires

Cette fonction utilise le membre BufferStruct de l’union CommandData dans la structure AVC_STREAM_REQUEST_BLOCK comme indiqué ci-dessous.

typedef struct _AVC_STREAM_REQUEST_BLOCK {
  ULONG  SizeOfThisBlock;
  ULONG  Version;
  AVCSTRM_FUNCTION  Function;
  .
  .
  PVOID AVCStreamContext;
  .
  .
  union _tagCommandData {
    .
    .
    AVCSTRM_BUFFER_STRUCT  BufferStruct;
    .
    .
  } CommandData;
} AVC_STREAM_REQUEST_BLOCK, *PAVC_STREAM_REQUEST_BLOCK;