Freigeben über


DVD_COPY_PROTECT_KEY Struktur (ntddcdvd.h)

Die DVD_COPY_PROTECT_KEY Struktur wird zusammen mit der IOCTL_DVD_READ_KEY Anforderung verwendet, um einen Berichtstastenbefehl des angegebenen Typs auszuführen.

Syntax

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;

Angehörige

KeyLength

Gibt die Länge der abzurufenden Schlüsseldaten an.

SessionId

Gibt die DVD-Sitzungs-ID an. Die Authentifizierungserteilungs-ID (Authentication Grant Identifier, AGID) für eine sichere AACS-Sitzung (Advanced Access Content System) ist eine lange ganze Zahl im Bereich -1 bis einschließlich 3.

KeyType

Gibt den Schlüsseltyp an. Der DVD-Gerätetreiber verwendet diese Informationen, um das Schlüsselformat in einem Berichtstastenbefehl zu bestimmen, wie durch die SCSI Multimedia Commands - 3 (MMC-3) Spezifikation definiert. Ein Berichtsschlüsselbefehl meldet schlüsseldaten für einen angegebenen Schlüssel (Abfrageschlüssel, Busschlüssel, Titelschlüssel, RPC-Schlüssel oder Datenträgerschlüssel), meldet den Status der Authentifizierungserfolgskennzeichnung (Authentifizierungs-Erfolgskennzeichnung, ASF) oder ungültig eine Authentifizierungserteilungs-ID (AGID). Weitere Informationen finden Sie in der MMC-3 Spezifikation.

KeyFlags

Dieses Element kann einen der folgenden Werte aufweisen:

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

Parameters

Parameters.FileHandle

Zeigen Sie auf das Dateihandle für das physische Gerät, an dem der Kopierschutz ausgehandelt wird.

Parameters.TitleOffset

Enthält die logische Blockadresse auf dem Medium des Titels.

Die oberen Ebenen des Betriebssystems verwenden das FileHandle Member. Das Dateisystem konvertiert den Wert in FileHandle- in eine logische Blockadresse und speichert das Ergebnis im TitleOffset Member. Kernelmodustreiber verwenden das TitleOffset Member.

KeyData[0]

Enthält die schlüsseldaten, die zurückgegeben wurden.

Anforderungen

Anforderung Wert
Header- ntddcdvd.h (enthalten Ntddcdvd.h)

Siehe auch

DVD_KEY_TYPE

IOCTL_DVD_READ_KEY