ID3DXFileData::Lock-Methode

Greift auf die X-Dateidaten zu.

Syntax

HRESULT Lock(
  [in]       SIZE_T *pSize,
  [in] const VOID   **ppData
);

Parameter

pSize [in]

Typ: SIZE_T*

Zeiger auf die Größe der X-Dateidaten.

ppData [in]

Typ: const VOID**

Adresse eines Zeigers zum Empfangen des Schnittstellenzeigers des ID3DXFileData-Dateidatenobjekts . Siehe Hinweise.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Methode fehlschlägt, wird der folgende Wert zurückgegeben: D3DXFERR_BADVALUE.

Bemerkungen

Der ppData-Zeiger ist nur während einer ID3DXFileData::Lock ... ID3DXFileData::Unlock-Sequenz . Sie können mehrere Sperraufrufe tätigen. Sie müssen jedoch sicherstellen, dass die Anzahl der Sperranrufe mit der Anzahl der Entsperrungsaufrufe übereinstimmt.

Da dateidaten nicht garantiert ordnungsgemäß an Bytegrenzen ausgerichtet sind, sollten Sie mit UNALIGNED-Zeigern auf ppData zugreifen.

Zurückgegebene Parameterwerte sind aufgrund einer möglichen Dateibeschädigung nicht garantiert gültig. Daher sollte Ihr Code die zurückgegebenen Parameterwerte überprüfen.

Anforderungen

Siehe auch

ID3DXFileData