structure DVD_COPY_PROTECT_KEY (ntddcdvd.h)

La structure DVD_COPY_PROTECT_KEY est utilisée conjointement avec la IOCTL_DVD_READ_KEY demande d’exécution d’une commande de clé de rapport du type spécifié.

Syntaxe

typedef struct _DVD_COPY_PROTECT_KEY {
  ULONG          KeyLength;
  DVD_SESSION_ID SessionId;
  DVD_KEY_TYPE   KeyType;
  ULONG          KeyFlags;
  union {
    HANDLE        FileHandle;
    LARGE_INTEGER TitleOffset;
  } Parameters;
  UCHAR          KeyData[0];
} DVD_COPY_PROTECT_KEY, *PDVD_COPY_PROTECT_KEY;

Membres

KeyLength

Indique la longueur des données clés à récupérer.

SessionId

Indique l’ID de session DVD. L’identificateur d’octroi d’authentification (AGID) pour une session AACS (Advanced Access Content System) sécurisée est un entier long compris entre -1 et 3 inclus.

KeyType

Indique le type de clé. Le pilote de périphérique DVD utilise ces informations pour déterminer le format de clé dans une commande de clé de rapport, comme défini par la spécification SCSI Multimedia Commands - 3 (MMC-3). Une commande de clé de rapport signale les données clés d’une clé spécifiée (clé de défi, clé de bus, clé de titre, clé RPC ou clé de disque), signale l’état de l’indicateur de réussite de l’authentification (ASF) ou invalide un ID d’octroi d’authentification (AGID). Pour plus d’informations, consultez la spécification MMC-3 .

KeyFlags

Ce membre peut avoir l’une des valeurs suivantes :

################

Parameters

Parameters.FileHandle

Pointeur vers le handle de fichier pour l’appareil physique sur lequel la protection contre la copie est en cours de négociation.

Parameters.TitleOffset

Contient l’adresse de bloc logique sur le média du titre.

Les couches supérieures du système d’exploitation utilisent le membre FileHandle . Le système de fichiers convertit la valeur dans FileHandle en adresse de bloc logique et stocke le résultat dans le membre TitleOffset . Les pilotes en mode noyau utilisent le membre TitleOffset .

KeyData[0]

Contient les données clés qui ont été retournées.

Configuration requise

Condition requise	Valeur
En-tête	ntddcdvd.h (inclure Ntddcdvd.h)

Voir aussi

DVD_KEY_TYPE

IOCTL_DVD_READ_KEY