DVD_COPY_PROTECT_KEY-Struktur (ntddcdvd.h)
Die DVD_COPY_PROTECT_KEY-Struktur wird in Verbindung mit der IOCTL_DVD_READ_KEY-Anforderung verwendet, um einen Berichtsschlüsselbefehl 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;
Member
KeyLength
Gibt die Länge der abzurufenden Schlüsseldaten an.
SessionId
Gibt die DVD-Sitzungs-ID an. Der Authentifizierungsgewährungsbezeichner (Authentication Grant Identifier, AGID) für eine sichere AACS-Sitzung (Advanced Access Content System) ist eine lange ganze Zahl im Bereich von -1 bis einschließlich 3.
KeyType
Gibt den Schlüsseltyp an. Der DVD-Gerätetreiber verwendet diese Informationen, um das Schlüsselformat in einem Berichtsschlüsselbefehl zu bestimmen, wie in der Spezifikation SCSI Multimedia Commands - 3 (MMC-3) definiert. Ein Berichtsschlüsselbefehl meldet entweder Schlüsseldaten für einen angegebenen Schlüssel (Anforderungsschlüssel, Busschlüssel, Titelschlüssel, RPC-Schlüssel oder Datenträgerschlüssel), meldet den Status des Authentifizierungserfolgsflags (ASF) oder ungültigt eine Authentifizierungszuweisungs-ID (AGID). Weitere Informationen finden Sie in der Spezifikation MMC-3 .
KeyFlags
Dieser Member kann über einen der folgenden Werte verfügen:
################
Parameters
Parameters.FileHandle
Zeiger auf das Dateihandle für das physische Gerät, auf dem der Kopierschutz ausgehandelt wird.
Parameters.TitleOffset
Enthält die logische Blockadresse auf den Medien des Titels.
Die oberen Ebenen des Betriebssystems verwenden den FileHandle-Member . Das Dateisystem konvertiert den Wert in FileHandle in eine logische Blockadresse und speichert das Ergebnis im TitleOffset-Element . Kernelmodustreiber verwenden das TitleOffset-Element .
KeyData[0]
Enthält die zurückgegebenen Schlüsseldaten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddcdvd.h (include Ntddcdvd.h) |