structure STATUS_BLOCK (video.h)

  • Article

La structure STATUS_BLOCK est une sous-structure au sein de la structure VIDEO_REQUEST_PACKET. La fonction HwVidStartIO d’un pilote miniport doit définir le bloc status de chaque VRP qu’il obtient.

Syntaxe

typedef struct _STATUS_BLOCK {
  union {
    VP_STATUS Status;
    PVOID     Pointer;
  };
  ULONG_PTR Information;
} STATUS_BLOCK, *PSTATUS_BLOCK;

Membres

Status

Indique le résultat de l’opération demandée. Ce membre peut être l’un des codes status suivants :

ERROR_INSUFFICIENT_BUFFER

Soit le VRP InputBuffer est trop petit pour fournir les données requises pour traiter la demande donnée, soit le OutputBuffer est trop petit pour renvoyer les données demandées.

ERROR_INVALID_FUNCTION

Le pilote miniport ne gère pas cette requête.

ERROR_INVALID_PARAMETER

Un paramètre dans le VRP n’est pas valide.

ERROR_IO_PENDING

Une opération n’est pas encore terminée.

ERROR_MORE_DATA

Le pilote a des données supplémentaires à retourner, mais il a déjà rempli le VRP OutputBuffer donné.

ERROR_NOT_ENOUGH_MEMORY

La mémoire est insuffisante pour traiter la demande.

NO_ERROR

L’opération demandée a été effectuée et terminée avec succès.

Pointer

Doit être ignoré par le pilote miniport. Ce membre de l’union existe pour garantir l’alignement des champs sur les systèmes 32 et 64 bits.

Information

Fournit des informations supplémentaires sur l’opération terminée. La signification de la valeur varie en fonction du VRP. En règle générale, ce membre est utilisé pour renvoyer la taille minimale requise pour la mémoire tampon d’entrée si le VRP transmet des données dans l’InputBuffer. Elle contient également le nombre d’octets de données transférés si l’opération demandée retourne des données dans le VRP OutputBuffer.

Configuration requise

Condition requise Valeur
En-tête video.h (inclure Video.h)

Voir aussi

HwVidStartIO

VIDEO_REQUEST_PACKET