Fonction VideoPortSetBusData (video.h)

La fonction VideoPortSetBusData définit les données de configuration de bus d’un adaptateur sur un bus d’E/S configurable dynamiquement avec une interface standard publiée.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
       PVOID         HwDeviceExtension,
       BUS_DATA_TYPE BusDataType,
       ULONG         SlotNumber,
  [in] PVOID         Buffer,
       ULONG         Offset,
       ULONG         Length
);

Paramètres

HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

BusDataType

Spécifie le type de données de bus à définir. Actuellement, sa valeur peut être Cmos, EisaConfiguration ou PCIConfiguration. Toutefois, d’autres types de bus standardisés et configurables dynamiquement peuvent être pris en charge à l’avenir. La limite supérieure sur les types de bus pris en charge est toujours MaximumBusDataType.

SlotNumber

Pour une valeur BusDataType de Cmos, spécifie l’emplacement de l’appareil sur le bus. Ce paramètre doit être égal à zéro pour tous les autres types de bus.

[in] Buffer

Pointeur vers une zone de stockage fournie par l’appelant avec des informations de configuration spécifiques à BusDataType.

Lorsque PCIConfiguration est spécifié, la mémoire tampon contient tout ou partie des informations PCI_COMMON_CONFIG pour le slotNumber donné. Le décalage et la longueur spécifiés déterminent la quantité d’informations fournies.

Offset

Spécifie le décalage d’octet dans la structure PCI_COMMON_CONFIG à laquelle commencent les valeurs de configuration fournies par l’appelant. Un pilote miniport peut utiliser PCI_COMMON_HDR_LENGTH pour spécifier le décalage de la zone spécifique à l’appareil dans PCI_COMMON_CONFIG.

Length

Spécifie le nombre d’octets dans La mémoire tampon.

Valeur retournée

VideoPortSetBusData retourne le nombre d’octets de données correctement définis pour le slotNumber donné. Si le BusDataType donné n’est pas valide pour la plateforme actuelle ou si les informations fournies ne sont pas valides, VideoPortSetBusData retourne zéro.

Remarques

Les pilotes miniport d’adaptateurs d’un bus PCI appellent rarement VideoPortSetBusData, sauf si des circonstances inhabituelles ou la nature de la carte vidéo d’un pilote particulier nécessitent un tel appel.

Par exemple, un pilote miniport peut appeler VideoPortSetBusData pour effacer un bit dans le pci status inscrire si sa carte signale un abandon cible lors de l’initialisation. Si une carte vidéo PCI doit être configurée avec des données spécifiques à l’appareil, son pilote appelle également cette fonction. Dans les deux cas, un tel pilote est alors susceptible d’appeler VideoPortGetAccessRanges avec un pointeur RequestedResources vers un tableau de descripteurs de ressources fourni par le pilote.

VideoPortSetBusData ne peut pas être appelé à partir des fonctions HwVidInterrupt ou HwVidTimer d’un pilote miniport, ou à partir de VideoPortQueueDpc, ou d’un rappel à VideoPortSynchronizeExecution.

Configuration requise

Voir aussi

HalSetBusDataByOffset

HwVidFindAdapter

PCI_COMMON_CONFIG

PCI_SLOT_NUMBER

VideoPortGetAccessRanges

VideoPortGetBusData