StarBurn SDK (Software Development Kit) |
__stdcall STARBURN_IMPEX_API VOID StarBurn_CdvdBurnerGrabber_Cancel(IN PVOID p__PVOID__CdvdBurnerGrabber);
Parameters | Description |
IN PVOID p__PVOID__CdvdBurnerGrabber | Pointer to the CdvdBurnerGrabber object that toolkit allocated before with the call to StarBurn_CdvdBurnerGrabber_Create(). |
Nothing. This function cannot fail.
This function cancels current read or write process on the CD/DVD/Blu-Ray/HD-DVD burner.
There is no sample provided for this code so please check the code below.
StarBurn_Destroy, StarBurn_CdvdBurnerGrabber_Create, PCALLBACK, EXCEPTION_NUMBER, CDB_FAILURE_INFORMATION, StarBurn_CdvdBurnerGrabber_TrackAtOnceFromTree, StarBurn_CdvdBurnerGrabber_TrackAtOnceFromFile, StarBurn_CdvdBurnerGrabber_VideoCD, StarBurn_CdvdBurnerGrabber_TrackAtOnceFromPipe, StarBurn_CdvdBurnerGrabber_SuperVideoCD, StarBurn_CdvdBurnerGrabber_GrabTrack, StarBurn_CdvdBurnerGrabber_GrabCD, StarBurn_CdvdBurnerGrabber_GrabDVD
This example allocates CdvdBurnerGrabber object, cancels current I/O process and destroys the device object after it's not needed any more.
// Somewhere in the data region PVOID l__PVOID__CdvdBurnerGrabber; EXCEPTION_NUMBER l__EXCEPTION_NUMBER; ULONG l__ULONG__SystemError; CDB_FAILURE_INFORMATION l__CDB_FAILURE_INFORMATION; // Prepare exception text buffer RtlZeroMemory( &l__CHAR__ExceptionText, sizeof( l__CHAR__ExceptionText ) ); // Prepare CDB failure information RtlZeroMemory( &l__CDB_FAILURE_INFORMATION, sizeof( l__CDB_FAILURE_INFORMATION ) ); // Try to create CdvdBurnerGrabber on 0:0:4:0 with 32MB of cache l__EXCEPTION_NUMBER = StarBurn_CdvdBurnerGrabber_Create( &l__PVOID__CdvdBurnerGrabber, ( PCHAR )( &l__CHAR__ExceptionText ), sizeof( l__CHAR__ExceptionText ), &l__ULONG__SystemError, &l__CDB_FAILURE_INFORMATION, ( PCALLBACK )( StarBurn_Callback ), 0, 0, 4, 0, 32 ); // Check for correct reply if ( l__EXCEPTION_NUMBER != EN_SUCCESS ) { // Handle error here... } // Initiate some I/O process here // Cancel initated I/O process StarBurn_CdvdBurnerGrabber_Cancel(); // Destroy the CdvdBurnerGrabber StarBurn_Destroy( &l__PVOID__CdvdBurnerGrabber ); // Just check for pointer (paranoid?) if ( l__PVOID__CdvdBurnerGrabber != NULL ) { // Handle error here... }