structure STATUS_BLOCK (video.h)
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) |